Planning-with-Files 上手指南：AI代理为什么总忘事，这本“文件笔记本“怎么救

Planning-with-Files 上手指南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 想解决的正是它用文件系统当 AI 代理工作内存让计划活过窗口清空。外置笔记本三张 markdown 便签救回记忆最直觉的理解方式给代理一本外置笔记本。上下文窗口是易失的内存清一次就归零文件系统是硬盘写下去的东西一直都在。planning-with-files 的核心就三张便签task_plan.md → 任务分几个阶段、各阶段状态、关键决策 findings.md → 调研结论、技术取舍随手追加 progress.md → 干了什么、测试结果、踩过的坑任务一启动代理先把目标拆成阶段写进task_plan.md干活过程中每有发现就往findings.md里塞一笔每做完一步就在progress.md记一笔。让这份文件即状态管理真正生效的是生命周期钩子代理每轮对话开始、每次动手前钩子自动把task_plan.md的头几行读出来塞回窗口——你不用管它自己记得。所以就算中途/clear把窗口整个抹掉新会话第一件事就是重读三张便签从当前阶段接着往下走。差别一句话就能说清以前的计划只活在内存里现在文件系统状态管理把做到哪一步变成了磁盘上的事实。装好技能跑完第一个任务我拿到仓库后的动作很简单。先用一行命令把技能装到全局npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g然后对新会话说一句plan this task或者直接敲/plan。几秒钟后项目根目录多了三个 markdown 文件task_plan.md里列着拆好的阶段和状态字段findings.md和progress.md等着被填。接下来全程不用我操心记账代理做完一步就追加文件每轮开口前先复读计划。任务跑完三个文件就是一份完整的施工日志——哪个阶段完成了、为什么这么改、哪里报过错全在。三个场景看看它到底怎么扛活两个会话同时跑麻烦同一个仓库里开两个代理会话一个做重构、一个查线上故障两边都往同一份计划文件里写后写的直接覆盖先写的。处理给每个会话发一套隔离的计划目录目录名带日期加任务别名.planning/下各占一间房要切回哪个任务改一个指针文件就行。效果两个会话各写各的互不踩踏。后来还加了一道守卫哪个阶段明明做完又变回没做说明有人写脏了钩子会直接提示你去查git diff。凌晨清空上下文早上接着干麻烦任务跑到一半上下文满了你/clear或者干脆机器重启。新会话睁眼对你干过什么一无所知。处理session-catchup 恢复脚本会翻 IDE 里的历史会话找到三张便签最后一次被更新的时间点把中间发生的对话整理成一份补漏报告新会话直接定位到下一个没做完的阶段。效果项目内部基准里带这三个文件的会话平均 5 轮对话就重新进入状态裸代理要 13.3 轮而两边最后都跑绿了测试——省的是重新熟悉代码的时间。换个 IDE 也不想重装麻烦团队一半人用 Claude Code一半人用 Codex 或 Cursor同一套工作流不想配置两遍。处理同一份技能文件和脚本走标准技能格式分发60 多个代理工具都能识别Claude Code、Codex 这类增强平台额外装上生命周期钩子每轮对话前自动读计划、写完文件后提醒补进度。效果在 Cursor 或 OpenCode 上标准技能发现路径直接认出同一份文件文件系统状态管理变成跨工具统一的记忆层。它到底值不值得装planning-with-files 做的事其实只有一件把计划从会死的内存里搬到不会死的磁盘上。至于这本笔记本能不能真变成所有 AI 代理的标配或许得看你下次/clear之后它还记得几件事。【免费下载链接】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），仅供参考