Planning-with-Files完整指南让AI编码助手像Manus一样高效工作的终极秘诀【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files你是否曾经遇到过AI助手在复杂任务中迷失方向忘记最初的目标或者在进行长时间编码任务时上下文突然丢失导致所有进度归零Planning-with-Files正是解决这些痛点的持久化文件规划技能它让AI编码助手能够像Meta以20亿美元收购的Manus公司一样高效工作。这个开源项目通过基于文件的规划系统为AI编码助手和长时间运行的代理任务提供了崩溃防护的Markdown计划确保即使上下文丢失或使用/clear命令后工作状态也能完美恢复。它实现了Manus风格的文件规划模式支持Claude Code、Codex CLI、Cursor、Kiro、OpenCode等60多种AI代理。 为什么你需要Planning-with-FilesAI编码助手虽然强大但在处理复杂任务时常常面临几个关键问题三大核心痛点易失性记忆问题- TodoWrite工具在上下文重置时会消失目标漂移现象- 经过50次工具调用后原始目标容易被遗忘上下文溢出风险- 所有信息都塞进上下文窗口而不是持久化存储Planning-with-files通过三文件工作模式完美解决了这些问题将文件系统作为持久化的工作记忆让AI助手能够处理任意复杂的任务。 核心文件系统你的磁盘工作记忆task_plan.md - 任务路线图这是你的任务执行蓝图相当于磁盘上的工作记忆。在开始任何工作之前必须首先创建这个文件。关键功能目标设定用一句话清晰描述最终状态阶段划分将任务分解为3-7个逻辑阶段状态追踪记录每个阶段的进展pending→in_progress→complete决策记录技术决策及其背后的理由错误日志遇到的每个错误、尝试次数和解决方案findings.md - 知识发现库由于AI的上下文窗口有限这个文件就是你的外部记忆——持久化且无限制。关键规则2-Action规则在每2次查看/浏览/搜索操作之后立即将关键发现保存到文本文件中。这个规则防止视觉/多模态信息丢失。记住截图、PDF内容和浏览器结果不会持久化必须立即捕获为文本progress.md - 会话日志按时间顺序记录你做了什么、什么时候做的以及发生了什么是你的完整工作历史记录。 5分钟快速上手指南第一步安装与初始化Planning-with-Files支持60种AI代理平台安装极其简单# 通用安装命令 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g # 中文版本 npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zh -g # Claude Code插件安装 /plugin marketplace add OthmanAdi/planning-with-files /plugin install planning-with-filesplanning-with-files第二步启动规划会话在你的AI编码助手中使用以下命令命令自动完成描述/planning-with-files:plan输入/plan启动规划会话/planning-with-files:status输入/plan:status查看规划进度/planning-with-files:pwf输入/pwf/plan的简短别名第三步三文件协同工作流程一旦启动AI助手会自动创建三个核心文件并开始智能规划创建task_plan.md- 定义目标、阶段和关键问题创建findings.md- 准备接收研究结果创建progress.md- 建立会话记录基础 高级功能与使用场景会话恢复机制当你的上下文填满并运行/clear时这个技能会自动恢复之前的会话{ autoCompact: false }工作原理检查活动IDE的会话存储中的先前会话数据查找规划文件最后更新时间提取之后发生的对话可能丢失的上下文显示恢复报告以便同步v3长期运行代理功能v3版本专门为长时间运行的代理任务设计提供了强大的新功能功能命令/标志描述自主模式/pwf --autonomous删除每次工具调用的计划重述保留回合开始注入门控模式--gated添加停止完成门仅当所有完成条件同时满足时才阻止Pi自动继续agent_end处理器重新提示代理最多3次以保持未完成计划继续SHA-256计划认证/plan-attest锁定task_plan.md篡改的计划体在注入时被拒绝多语言支持Planning-with-Files提供5种语言版本满足全球开发者需求语言安装命令阿拉伯语npx skills add OthmanAdi/planning-with-files --skill planning-with-files-ar -g德语npx skills add OthmanAdi/planning-with-files --skill planning-with-files-de -g西班牙语npx skills add OthmanAdi/planning-with-files --skill planning-with-files-es -g简体中文npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zh -g繁体中文npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zht -g 实际应用场景与最佳实践场景1复杂项目开发适用任务构建完整的Web应用、开发库、重构大型代码库工作流程1. 使用 /plan 启动项目规划 2. 在 task_plan.md 中定义5个阶段 - 需求分析 - 架构设计 - 核心实现 - 测试验证 - 部署交付 3. 每个阶段完成后更新状态 4. 所有技术决策记录在 findings.md 5. 所有代码变更记录在 progress.md场景2研究分析任务适用任务市场调研、技术评估、数据分析工作流程1. 使用 /plan 定义研究目标 2. 严格遵守2-Action规则 - 第一次研究 → 记录到 findings.md - 第二次研究 → 必须更新 findings.md 3. 使用表格整理研究结果 4. 结论汇总到 task_plan.md 的决策部分场景3Bug修复与调试适用任务复杂Bug调查、性能优化、安全漏洞修复工作流程1. 使用 /plan 描述问题现象 2. 在 findings.md 中记录 - 复现步骤 - 错误日志 - 已尝试的解决方案 3. 使用3-Strike错误协议 - 尝试1 → 诊断修复 - 尝试2 → 不同方法 - 尝试3 → 重新思考️ 错误处理与恢复策略3-Strike错误协议Planning-with-Files强制执行智能错误处理尝试次数处理策略记录要求第1次诊断并修复记录错误和解决方案第2次使用不同方法记录新方法和结果第3次重新思考问题记录根本原因分析会话中断恢复当AI助手会话意外中断时恢复流程如下自动检测- 系统检查是否有未完成的规划文件上下文重建- 从磁盘重新读取三个核心文件状态同步- 恢复所有阶段状态和进度继续执行- 从上次中断的地方继续工作 性能与兼容性基准测试结果Planning-with-Files经过严格测试在复杂任务中表现优异测试指标使用技能未使用技能通过率30个断言96.7%(29/30)6.7% (2/30)3文件模式遵循5/5 评估0/5 评估盲测A/B获胜3/3 (100%)0/3平均评分10.0/106.8/10支持的IDE平台Planning-with-Files兼容18个主流AI编码平台平台类型支持平台集成级别增强支持Claude Code, Cursor, GitHub Copilot, Mastra Code, Gemini CLI, Kiro, Codex, Hermes Agent, CodeBuddy, FactoryAI Droid, OpenCode钩子 生命周期自动化标准技能支持Continue, Pi Agent, OpenClaw, Autohand Code, Antigravity, Kilocode, AdaL CLIAgent Skills规范 项目结构与文件组织Planning-with-Files项目采用模块化设计确保灵活性和可扩展性planning-with-files/ ├── commands/ # 插件命令 ├── docs/ # 完整文档 ├── examples/ # 集成示例 ├── media/ # 图片资源 ├── scripts/ # 核心脚本 ├── skills/ # 技能变体多语言 ├── templates/ # 模板文件 └── tests/ # 测试套件核心模板文件位置templates/task_plan.md- 任务计划模板templates/findings.md- 研究发现模板templates/progress.md- 进度记录模板 实用技巧与最佳实践1. 目标保持技巧在做出重大决策前重新阅读task_plan.md使用PreToolUse钩子自动读取计划文件定期更新5-Question Reboot Check2. 文件位置管理重要提示你的规划文件应该在你的项目目录中创建——你正在工作的文件夹而不是埋在技能安装文件夹中。3. 并行任务处理对于多个不相关的任务使用隔离的计划目录./scripts/init-session.sh backend-refactor ./scripts/init-session.sh production-incident ./scripts/set-active-plan.sh 2026-01-10-backend-refactor 常见错误避免指南错误做法正确做法❌ 不创建task_plan.md就开始工作✅ 始终先创建计划文件❌ 忘记在2次浏览器操作后更新findings.md✅ 设置提醒2次查看/浏览操作 更新findings.md❌ 不记录错误因为快速解决了✅ 记录所有错误即使你立即解决了❌ 重复相同的失败操作✅ 如果某件事失败记录下来并尝试不同的方法 持续集成与社区贡献Planning-with-Files拥有活跃的社区和持续的开发版本迭代- 从v2.x到v3.x的持续改进多语言支持- 5种语言版本的完整支持社区扩展- 多个社区分支和扩展项目安全审计- 定期安全审计和漏洞修复 开始使用Planning-with-Files现在你已经了解了Planning-with-Files的强大功能是时候开始使用了选择安装方式- 根据你的AI编码平台选择合适的安装命令启动第一个规划- 使用/plan命令开始你的第一个复杂任务体验持久化记忆- 观察AI助手如何保持目标一致性测试恢复能力- 故意使用/clear命令验证会话恢复记住核心原则文件系统就是磁盘持久化、无限制上下文窗口就是RAM易失、有限——任何重要的内容都应该写入磁盘通过掌握Planning-with-Files你将能够像Manus的AI工程师一样高效管理复杂任务避免目标漂移和上下文丢失问题。无论是构建完整的应用程序、进行深度研究还是调试复杂问题这个工具都将成为你AI编码工作流中不可或缺的一部分。立即开始让你的AI编码助手获得持久化的工作记忆处理更复杂的任务实现更高效的开发工作流【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考