产品简介
planning-with-files 面向使用 AI 编码代理（如 Claude Code、Codex）的开发者，通过 task_plan.md、findings.md 和 progress.md 三个文件存储计划、发现和进度，防止上下文重置、崩溃和压缩导致的数据丢失，支持会话恢复和每轮自动重新注入，确保复杂任务持续执行。
核心功能
- 基于文件的持久化规划（三个 markdown 文件）
- 崩溃和上下文重置后自动恢复
- 每轮自动重新注入计划防止上下文腐烂
- 确定性完成门控（仅所有阶段完成后停止）
- 支持 60+ AI 编码代理通过 Agent Skills 标准
快速开始
- 安装工具：对 Claude Code 使用插件命令，对其他代理使用 npx skills add 命令。
- 触发规划：在代理中输入 /plan 或请求代理规划任务。
- 工具自动管理：代理创建并更新 task_plan.md、findings.md 和 progress.md 三个文件。
界面预览
与其他方案对比
| 对比项 | planning-with-files | 同类方案 |
|---|---|---|
| 上下文重置后恢复速度 | 平均 5.0 轮自动恢复计划和进度 | 平均 13.3 轮，需要手动重新描述任务 |
适合谁用
- 使用 Claude Code、Codex 等 AI 编码代理的开发者
- 处理长时间编码任务的开发者
- 需要任务崩溃恢复和上下文持久化的开发者
下载与版本
当前最新版本为 v3.8.1，发布于 2026-07-21。支持 Windows、macOS、Linux。点击页面「下载软件」按钮即可下载打包好的版本，根据你的电脑/手机系统来选择对应的软件。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/OthmanAdi/planning-with-files