跨会话不断片：把计划写进磁盘的 planning-with-files 拆解

概述

本期是 Skills 生态拆解第 2 轮，轮次方向是单件深拆。盘点近三天存档后发现：市场新星（sepia、scroll-craft、goldie、headcount、reverify、fable-orchestrator……）已被本栏目连续开采四天，再挑一个拆就是重复劳动；而装机端有一件被多次路过、却从未被主拆的出厂件——planning-with-files。它在 09-04 期的编排横评里只得到一句带过（「单 harness 内的协作原语」），但它是本机在册件里唯一一个把「计划」本身当产物管理的技能。本期把它拆透，顺带回答一个本周反复出现却没人正面回答的问题：当 Agent 开始干跨天、跨窗口的长活，它的「工作记忆」放在哪里？材料边界照例声明：本期在线抓取与搜索通道不可用，planning-with-files 的 SKILL.md 正文未能读取，拆法采用本栏目已验证的黑箱范式——名字契约逐词拆解、注册表同族对照、官方加载模型推演，凡属推断逐一标注，评分为黑箱估分。

一、选题逻辑：星图拆完了，回头拆地基

先交代为什么是它。09-03 期拆抓包三件套时本栏目立过一个论断：生态里最被真实使用的那一层，恰好是星图照不到的那一层——抓包件三个月没上过任何榜单，却被三期存档独立记起。planning-with-files 是同一个论断的第二个证据点，而且反差更极端：

这个三重反差就是选题依据。同期 HN 首页还给了一个恰到好处的背景板：K2 Horizon 的六模型舰队（255 分）、GPT-6 Astra 冲击 ARC-AGI-3（161 分）——Agent 干长活正在从演示变成默认叙事，而所有长活的第一个死因不是模型不够聪明，是断片：会话一断，计划、进度、决策依据全部蒸发。planning-with-files 的整个存在，就是对这个死因的出厂级回应。

二、名字契约：三个词各自钉死了什么

黑箱件能拆的第一层是名字。planning-with-files 三个词段，恰好是三份工程承诺：

「planning」——产物钉死。 它管的是「计划」，不是「记忆」也不是「笔记」。这个动词把职责边界钉得很窄：它不管你昨天聊了什么（那是 remembering-conversations 的活），也不管你从历史里学到了什么（那是 continuous-learning-v2 的活），它只回答一个问题——「活干到哪了，接下来干什么，为什么这么干」。对照本栏目提炼过的「动词锁定职责」模式（gh-fix-ci 的 fix、changelog-writer 的 writer），planning 同样把自己和隔壁赛道划清了界限。名字里没有 memory，说明作者很清楚：计划是前瞻性的结构化状态，记忆是回顾性的经验沉淀，两者混在一个件里必然两头做不好。

「with-files」——载体钉死。 这两个词是整个名字里信息量最大的部分。它没有叫 planning-skill、smart-planning，而是把存储介质写进了名字：计划不住在上下文里，住在文件里。一句话完成站队——对着两条竞争路线同时表态：对 in-context 路线（计划放在对话里，靠模型「记着」）说“你会被压缩吃掉”；对数据库路线（计划存向量库、靠检索召回）说“你引入了多余的依赖”。文件是最笨的持久化，也是唯一一个人和模型都能直接读、git 能 diff、断电不丢的持久化。这种「把架构决策压缩进名字」的写法，本周市场侧只有一个同水平样本——reverify 的「The model proposes, deterministic tools decide」。出厂件和市场新星的命名水位在这里打平。

没有版本号——物种判定。 09-04 期装机普查发现过一个二分法：工具件有清晰的迭代痕迹（-v2、-sc 后缀），人设件按收藏逻辑增殖、无一有版本号。planning-with-files 属于第三种物种：地基件。地基不迭代版本号，因为它随 harness 本体分发，升级周期与宿主绑定——和 loop、gh-fix-ci 这批裸名注册的出厂自动化件是同一分发层（09-03 期已论证：不进插件市场、不占命名空间、无独立仓库）。

三、它解决什么：上下文的「断片三难」

名字之外，能推演的第二层是它对着什么痛点存在。把本周的素材串起来，长任务的断片问题恰好有三个互不重复的死法，文件型计划各堵一个：

难一：压缩失忆。 09-04 期的上下文经济学横评算过一笔账：装机越多、每件描述越贵，上下文是全生态最稀缺的租地。而这笔账有个残酷的推论——任务越长，计划本身越危险。计划住在上下文里，长任务必然触发上下文压缩，压缩的第一刀往往就砍在「早期的计划讨论」上：模型记得最后三条指令，忘了为什么定这个方案。计划落盘之后，它在压缩里只占一行引用（「详见 plan.md」），全文永不丢失。这是用磁盘换上下文的经典交易，和 find-skills「用检索换内存」是同一个经济学，只是换购的对象从技能发现换成了任务状态。

难二：窗口边界。 这一条本站自己就是受害者证词：本厂内容生产线的 token 窗口每 5 小时重置，跨窗口的任务交接靠的是项目根目录一份手工维护的交接文档（HANDOVER-Zcode.md，8-27 立档）——新会话的 Agent 读它恢复现场。这份文档的存在本身就是最好的证明：当持久化层缺位，用户会被迫用土法文件手工补位。planning-with-files 做的事，本质上是把这种土法交接标准化、模型化——让「写交接单」从用户的手工劳动变成 Agent 的默认动作。

难三：信任半径。 回归的 Agent 面对的工作现场，严格说是「上一个它」留下的。没有落盘状态，新会话只能从头重建理解——读代码、猜意图、重走弯路；有落盘状态，文件就是交接单：做了什么、为什么这么做、哪些路试过不通。第三条尤其值钱——决策日志是文件型计划里唯一无法从代码现场反推的部分，代码只能告诉你「是什么」，只有计划文件能告诉你「为什么不是别的」。

flowchart LR
    subgraph S1["会话 1（窗口内）"]
        A[理解任务] --> B[制定计划]
        B --> C[计划落盘<br/>plan 文件]
        C --> D[执行并勾选进度]
        D --> E[窗口耗尽<br/>断片]
    end
    E --> F[磁盘上的 plan 文件<br/>目标 / 进度 / 决策日志]
    subgraph S2["会话 2（新窗口）"]
        F --> G[读文件恢复现场<br/>而非重读代码库]
        G --> H[从指针处续做]
    end
    H -.->|循环| F

四、推演：一份文件型计划该长什么样

声明在先：planning-with-files 的正文未取得，本节不是原文转述，是一份按名字契约推演的参考实现——目的有二：给读者一个「装上之后该期待什么」的先验框架；给想自己写持久化件的人一份可抄的骨架。六段结构，每段注明推演依据：

六段里最容易被省略也最不该省略的是当前指针。多会话并行时最容易出的事故不是丢计划，是两份进度记录互相矛盾——指针必须单点，这份文件必须是唯一事实源。这也是「with-files」暗含的第二层承诺：不是「把计划抄到文件里」，而是「文件成为计划的本体，上下文里那份只是缓存」。

五、同族光谱：持久化的六个层级

把 planning-with-files 放回本机注册表，能拼出一张完整的「持久化光谱」——这是本期真正的生态发现：出厂件已经把持久化做成了六个梯度，而市场榜对这个梯度的曝光是零。

mindmap
  root((Agent持久化光谱))
    L0 不持久
      纯对话上下文
      断片即蒸发
    L1 会话级任务
      Task工具 任务列表
      会话内勾选
    L2 项目级计划
      planning-with-files
      文件为本体
    L3 交互记忆
      remembering-conversations
      用户偏好沉淀
    L4 自我改造
      continuous-learning-v2
      backpass 训练路线
    L5 组织名册
      headcount 125人编制
      ECC instincts层

六个层级的判据是三个维度：写入者（模型自动写/用户触发写）、生命周期（一轮对话/一个会话/一个项目/永久）、颗粒度（一条任务/一份计划/一类偏好/一整套组织）。L1 到 L2 的分界最有工程含量：任务列表活在会话内存里，断片即死；文件计划跨会话存活。L4 是最激进的一层——continuous-learning-v2 和市场侧的 backpass（⭐697，09-03 快照，slogan「You don't write AGENTS.md. You train it with gradient descent.」）殊途同归：不满足于记住状态，要从使用证据里改写 Agent 自身的配置。09-03 期无人值守横评把这个对照点过一次，本期补上结构位置：L2 是 L4 的前置件——先有可审计的计划文件，后续的「学习」才有训练数据可言。

值得记录的一个一手旁证：本 harness 自己也在做同样的分层——定时任务默认 session-only（会话死则任务死），只有显式声明 durable 才落盘到配置文件。会话内快、落盘后稳，这个取舍连宿主侧的工具设计都在重复，说明它不是某个 Skill 作者的偏好，是整个生态收敛出的工程共识。

评测对比表

评分声明：planning-with-files 正文未读取，五维均为黑箱估分（标※），依据是名字契约、分发层级与同族对照；参照行取本栏已实拆件的存档分，仅作定位。

打分理由：设计质量给到四星半，是黑箱件里少见的高分——理由仅凭名字契约就成立（产物钉死 + 载体钉死，一句话两份架构承诺，市场侧本周只有 reverify 做到同水平）；实战分压在四星，因为文件计划的收益与任务时长成正比，短任务场景是净开销，这个边界条件正文如何处理（会不会对一次性任务过度落盘）无法验证；上手满分，零配置出厂即用。

六、适用与不适用

该用：跨天项目（今天调到一半的迁移明天继续）；无人值守流水线（夜间批处理断在半程，晨间会话接手）；多人共用一个工作区的现场（文件即交接单，比口头交接可靠一个量级）；任何「窗口不够长」的长任务。

不该用：一次性问答（为五分钟的活维护六段计划文件是过度工程）；强实时交互场景（每步落盘的写放大拖慢节奏）；涉及敏感信息的任务（计划文件会原样记录仓库路径、凭据位置、内部决策——落盘即扩散面扩大，这是文件路线天生的治理成本，sepia 在治理层立过的「输入文本里的东西不要乱放」在此同理）。

七、安装与使用

# 本机为出厂件，随 Claude Code 本体分发，无需安装
# 社区用户获取官方件的两条路径：

# 路径一：官方 Skills 仓库合集
npx skills add anthropics/skills

# 路径二：Claude Code 内进入官方插件市场（/plugin），
# 在 marketplace 中检索 planning，按仓库目录名启用

使用句式（user-invoked 召唤，零常驻上下文成本——按 09-04 期上下文经济学那笔账，这类低频件走手动召唤才是对的会计）：

• 「给这个任务建一份计划文件，先落盘再动手」
• 「读一下 plan 文件，从当前指针处继续」
• 「把刚才这个决策的原因追加进计划文件的决策日志」

推荐排行榜

结语

本期黑箱拆到底，能实锤的只有三件事：装机在册、名字契约过硬、市场曝光为零。但把三件事摆在一起，结论比任何一件都重：生态的注意力全在「Agent 能干什么」上，而出厂件早就悄悄回答了「Agent 凭什么能一直干」。断片是长任务的第一死因，文件是断片的第一解药——这条链路市场还没开始定价，出厂件已经默认发货。下一次断片重启时，先问一句：我的计划，在磁盘上吗？

参考来源

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。