3个Markdown文件让AI智能体规划不断线

3个Markdown文件让AI智能体规划不断线【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files你让AI智能体连干两小时回来它开口问我们在做什么来着——这不是模型笨是上下文窗口天生易失一次/clear、一次自动压缩、一次意外崩溃之前立的计划就蒸发了。planning-with-files 的做法是把计划写进磁盘上的三个 Markdown 文件并在每一轮对话开始时把计划重新注回上下文让规划扛过上下文清空与压缩。效果有实测数字在仓库内置的恢复基准里会话被强制中断后新会话凭磁盘上的三个文件平均 5.0 轮就回到正轨裸智能体要 13.3 轮30 条可验证断言里启用技能后通过 29 条裸跑只通过 2 条方法详见 docs/evals.md。先看清失忆的四类损失把计划只留在窗口里跑长任务你会反复撞上四个坑待办清单活在窗口里窗口一清清单跟着消失50 次工具调用之后最初的目标被后续细节挤出注意力智能体开始打偏错误不落盘同一个坑第二次还得再踩一遍所有信息都硬塞窗口窗口填得更快压缩来得更早上下文窗口就那么点你打算拿它扛多长的任务这四个坑的根子其实是同一个智能体把易失内存当成了档案库。对策也随之简单——把计划请出窗口放到磁盘上。核心机制一份计划在盘上每回合注入一次整套机制的实体就是项目目录里的三个文件文件职责何时写入task_plan.md计划主线目标、3~7个阶段、状态、决策与错误表每个阶段收尾、做决策、出错时findings.md外部记忆研究发现、技术决策、资源发现即写连续2次检索后必写progress.md工作日志执行动作、测试结果、错误记录整个会话过程持续更新注意这三个文件生成在你的项目目录里技能目录只存放模板和脚本别把它们埋进安装目录。真正把循环转起来的是生命周期钩子Claude Code 插件路线默认注册 5 个钩子触发时机动作UserPromptSubmit每轮对话开始重新注入活动计划目标始终留在注意力窗口PreToolUseWrite/Edit/Bash 等之前重读计划防止执行中途忘目标PostToolUse文件写入之后提醒更新阶段状态与进度Stop智能体想收工时检查全部阶段是否完成gated 模式可拦下提前收工PreCompact压缩发生前提醒先把进度落盘并打印计划指纹每回合重注入是对抗上下文腐化的关键对话越长窗口里越早的指令越容易被挤掉但目标和当前阶段状态是刚从磁盘读进来的永远在注意力窗口里。窗口真断了还有兜底。执行/clear或开新会话后session-catchup 脚本会去 IDE 的会话存储里找上一次会话的数据对齐三个文件的最后修改时间提取中间发生过的工作生成一份补位报告。智能体对照报告和git diff重新回答我在哪、我做了什么然后直接续跑当前阶段——不用你再复述一遍需求。让智能体自律的4条铁律文件是骨架规则才是肌肉。这些规则写进了 SKILL.md靠钩子逐回合执行无计划不开工——任务预计超过 3 步或 5 次工具调用先把三个文件建出来再动手顺序不可颠倒。2-Action 规则——每 2 次查看/浏览/搜索操作后立即把关键发现写入findings.md。截图、PDF 和浏览器结果都不会持久化不写下来等于没看过。三击错误协议——第一次失败诊断修复第二次换方法第三次质疑前提。失败的原始动作不许原样重试每个错误连同尝试次数、解决方式记进错误表哪怕你十秒就修好了。不让智能体提前下班——gated 模式下只要还有 in_progress 阶段Stop 钩子不放行长时间无人值守跑任务时还可以用/plan-attest给计划上 SHA-256 锁被篡改的计划会拒绝注入。再补一个实用技巧同一个仓库并行跑多个任务时给每个任务起一个 slug文件会隔离到.planning/日期-slug/下用set-active-plan.sh切换活动计划两套工作互不踩踏。场景走查一次跨/clear的取消率归因拿一个真实复杂度跑一遍你给智能体一句话加一份全年订单流水 orders.csv——查一下近 30 天订单取消率为什么涨了 20%。智能体用数据分析模板仓库自带--template analytics立出四个阶段数据探查、探索分析、假设验证、报告输出。阶段一就发现承运商字段缺失 2000 行数据质量问题与清洗口径当场写进findings.md。阶段二做时间线拆解尖峰集中在第 3 周维度拆解把范围缩到一个物流区域发现照样落盘。这时上下文已经快满你执行了/clear。新会话启动session-catchup 读完三个文件与会话存储补位报告明确写着当前阶段三假设该区域取消率尖峰与某承运商时效劣化相关尚未验证。智能体不问你要一句背景直接从假设验证续跑。阶段三用留出数据交叉验证假设测试输入、预期、实际结果记入progress.md阶段四产出报告尖峰归因于某承运商区域时效劣化附应对建议。最后落盘的不只有一份能交付的报告还有三个完整规划文件——人直接打开也能读懂整个推导过程这算一个意外收获。收束计划住在智能体外面带走三条要点就够了计划住盘上回合回合注入检索两次落盘一次错误全部进表失败动作不许原样重试想收工先过闸门让检查脚本替智能体把关安装也是一行命令的事npx skills add OthmanAdi/planning-with-files --skill planning-with-files -gClaude Code 走插件路线则钩子和斜杠命令一步到位装完觉得钩子没动静跑一次/plan-doctor自检完整路线见 docs/installation.md。最后留一句可以贴在显示器上的话脑子只记下一步其余都落盘。上下文窗口是当班人的脑子容量有限还会断片三个 Markdown 文件是换班交接本谁来接班都从本子上读起——没写进本子的对下一个人来说就等于没发生过。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考