# 跨会话不断片：把计划写进磁盘的 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 面对的工作现场，严格说是「上一个它」留下的。没有落盘状态，新会话只能从头重建理解——读代码、猜意图、重走弯路；有落盘状态，文件就是交接单：做了什么、为什么这么做、哪些路试过不通。第三条尤其值钱——**决策日志是文件型计划里唯一无法从代码现场反推的部分**，代码只能告诉你「是什么」，只有计划文件能告诉你「为什么不是别的」。 ```mermaid flowchart LR subgraph S1["会话 1（窗口内）"] A[理解任务] --> B[制定计划] B --> C[计划落盘
plan 文件] C --> D[执行并勾选进度] D --> E[窗口耗尽
断片] end E --> F[磁盘上的 plan 文件
目标 / 进度 / 决策日志] subgraph S2["会话 2（新窗口）"] F --> G[读文件恢复现场
而非重读代码库] G --> H[从指针处续做] end H -.->|循环| F ``` ## 四、推演：一份文件型计划该长什么样 声明在先：planning-with-files 的正文未取得，**本节不是原文转述，是一份按名字契约推演的参考实现**——目的有二：给读者一个「装上之后该期待什么」的先验框架；给想自己写持久化件的人一份可抄的骨架。六段结构，每段注明推演依据： | 段落 | 内容 | 推演依据（本栏已验证样本） | |---|---|---| | 目标 / 非目标 | 一句话任务定义 + 明确不做什么 | 官方四件套「边界前置」立法；sepia 的校准原则 | | 现场快照 | 当前分支、关键路径、环境状态 | security-threat-model 的「证据锚定」：不声称无实证的状态 | | 阶段清单 | 可勾选的任务序列，每项有完成判据 | xlsx 的「零公式错误」门禁思路：判据可验证，不靠感觉 | | 当前指针 | 「下一步从这里开始」——唯一单点 | headcount 的路由表：一个入口，杜绝多指针打架 | | 决策日志 | 每个重大选择的「为什么 + 否决了什么」 | 威胁建模的「关键假设声明」：假设不明，结论不可信 | | 恢复指令 | 新会话第一句该读什么、先验什么 | update-config 的「堵错误路由」：把恢复动作写死，不留给现场发挥 | 六段里最容易被省略也最不该省略的是**当前指针**。多会话并行时最容易出的事故不是丢计划，是两份进度记录互相矛盾——指针必须单点，这份文件必须是唯一事实源。这也是「with-files」暗含的第二层承诺：不是「把计划抄到文件里」，而是「文件成为计划的**本体**，上下文里那份只是缓存」。 ## 五、同族光谱：持久化的六个层级 把 planning-with-files 放回本机注册表，能拼出一张完整的「持久化光谱」——这是本期真正的生态发现：**出厂件已经把持久化做成了六个梯度，而市场榜对这个梯度的曝光是零**。 ```mermaid 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 正文未读取，五维均为黑箱估分（标※），依据是名字契约、分发层级与同族对照；参照行取本栏已实拆件的存档分，仅作定位。 | 维度（权重） | planning-with-files※ | 参照：xlsx recalc 门禁 | 参照：long-running-agent※ | |---|---|---|---| | 功能完整度 25% | ★★★★ | ★★★★★ | ★★★★ | | 设计质量 25% | ★★★★☆ | ★★★★★ | ★★★☆ | | 实战效果 20% | ★★★★（长任务场景，未实测） | ★★★★★ | ★★★ | | 上手难度 15% | ★★★★★（出厂即用） | ★★★★ | ★★★★ | | 社区活跃度 15% | 出厂件，按分发方式记 | ★★★★★ | 出厂件，按分发方式记 | | **加权得分** | **4.15** | **4.9** | **3.75** | 打分理由：设计质量给到四星半，是黑箱件里少见的高分——理由仅凭名字契约就成立（产物钉死 + 载体钉死，一句话两份架构承诺，市场侧本周只有 reverify 做到同水平）；实战分压在四星，因为文件计划的收益与任务时长成正比，短任务场景是净开销，这个边界条件正文如何处理（会不会对一次性任务过度落盘）无法验证；上手满分，零配置出厂即用。 ## 六、适用与不适用 **该用**：跨天项目（今天调到一半的迁移明天继续）；无人值守流水线（夜间批处理断在半程，晨间会话接手）；多人共用一个工作区的现场（文件即交接单，比口头交接可靠一个量级）；任何「窗口不够长」的长任务。 **不该用**：一次性问答（为五分钟的活维护六段计划文件是过度工程）；强实时交互场景（每步落盘的写放大拖慢节奏）；涉及敏感信息的任务（计划文件会原样记录仓库路径、凭据位置、内部决策——**落盘即扩散面扩大**，这是文件路线天生的治理成本，sepia 在治理层立过的「输入文本里的东西不要乱放」在此同理）。 ## 七、安装与使用 ```bash # 本机为出厂件，随 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 等场景全覆盖。