28037★《planning-with-files：面向 AI 编码代理的文件持久化规划技能》
Planning with Files 是一个面向 AI 编码代理和长时任务的持久化文件规划技能。它不是一条代理可能遵守也可能忽略的提示词，而是一个每轮都会触发的钩子，一份写在磁盘上、能够挺过 /clear 的计划，README 中还给出了 3 比 0 的盲测 A/B 全胜结果来证明其效果。代理的上下文窗口会失效，而计划不会。
该技能在磁盘上维护三个文件：task_plan.md、findings.md 和 progress.md。已激活的生命周期钩子会按需注入选定的项目规划上下文，使计划在上下文丢失、/clear、崩溃和压缩（compaction）之后依然存活。自动恢复只读取项目文件；若要读取同一项目的本地代理会话记录以统计聚合计数或进行有界回放，则需要显式启用 catchup 模式。
项目通过 Agent Skills 标准可安装到 60 多种代理中，并为 Claude Code、Codex CLI、Qoder CLI、Pi、Hermes Agent、OpenCode 和 DeepSeek Harness 提供原生插件，可从 npm、Claude Code 插件市场或 npx skills 安装。
主要特点
- 基于磁盘的 Markdown 计划，抗崩溃、抗上下文腐化，每轮重新注入规划上下文
- 会话可在 /clear 和压缩（compaction）后自动恢复，恢复过程只读取项目文件
- 确定性的完成判定门（deterministic completion gate）
- 三份规划文件：
task_plan.md、findings.md、progress.md - 通过 Agent Skills 标准支持 60+ 代理，含 Claude Code、Codex CLI、Qoder CLI、Pi、Hermes Agent、OpenCode、DeepSeek Harness 的原生插件
- README 标注基准测试通过率 96.7%（29/30），盲测 A/B 3/3 全胜
📊 本项目 GitHub 星标数：28037。项目地址：https://github.com/OthmanAdi/planning-with-files
