Planning-with-Files完整指南：让AI编码助手像Manus一样高效工作的终极秘诀

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-Files？

AI编码助手虽然强大，但在处理复杂任务时常常面临几个关键问题：

三大核心痛点

1. 易失性记忆问题- TodoWrite工具在上下文重置时会消失
2. 目标漂移现象- 经过50+次工具调用后，原始目标容易被遗忘
3. 上下文溢出风险- 所有信息都塞进上下文窗口而不是持久化存储

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-files@planning-with-files

第二步：启动规划会话

在你的AI编码助手中使用以下命令：

第三步：三文件协同工作流程

一旦启动，AI助手会自动创建三个核心文件并开始智能规划：

1. 创建task_plan.md- 定义目标、阶段和关键问题
2. 创建findings.md- 准备接收研究结果
3. 创建progress.md- 建立会话记录基础

🔧 高级功能与使用场景

会话恢复机制

当你的上下文填满并运行/clear时，这个技能会自动恢复之前的会话：

{ "autoCompact": false }

工作原理：

1. 检查活动IDE的会话存储中的先前会话数据
2. 查找规划文件最后更新时间
3. 提取之后发生的对话（可能丢失的上下文）
4. 显示恢复报告以便同步

v3长期运行代理功能

v3版本专门为长时间运行的代理任务设计，提供了强大的新功能：

多语言支持

Planning-with-Files提供5种语言版本，满足全球开发者需求：

📊 实际应用场景与最佳实践

场景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 的决策部分

场景3：Bug修复与调试

适用任务：复杂Bug调查、性能优化、安全漏洞修复

工作流程：

1. 使用 `/plan` 描述问题现象 2. 在 findings.md 中记录： - 复现步骤 - 错误日志 - 已尝试的解决方案 3. 使用3-Strike错误协议： - 尝试1 → 诊断修复 - 尝试2 → 不同方法 - 尝试3 → 重新思考

🛡️ 错误处理与恢复策略

3-Strike错误协议

Planning-with-Files强制执行智能错误处理：

会话中断恢复

当AI助手会话意外中断时，恢复流程如下：

1. 自动检测- 系统检查是否有未完成的规划文件
2. 上下文重建- 从磁盘重新读取三个核心文件
3. 状态同步- 恢复所有阶段状态和进度
4. 继续执行- 从上次中断的地方继续工作

📈 性能与兼容性

基准测试结果

Planning-with-Files经过严格测试，在复杂任务中表现优异：

支持的IDE平台

Planning-with-Files兼容18+个主流AI编码平台：

🎨 项目结构与文件组织

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 Check

2. 文件位置管理

重要提示：你的规划文件应该在你的项目目录中创建——你正在工作的文件夹，而不是埋在技能安装文件夹中。

3. 并行任务处理

对于多个不相关的任务，使用隔离的计划目录：

./scripts/init-session.sh backend-refactor ./scripts/init-session.sh production-incident ./scripts/set-active-plan.sh 2026-01-10-backend-refactor

🚫 常见错误避免指南

🔄 持续集成与社区贡献

Planning-with-Files拥有活跃的社区和持续的开发：

• 版本迭代- 从v2.x到v3.x的持续改进
• 多语言支持- 5种语言版本的完整支持
• 社区扩展- 多个社区分支和扩展项目
• 安全审计- 定期安全审计和漏洞修复

🎉 开始使用Planning-with-Files

现在你已经了解了Planning-with-Files的强大功能，是时候开始使用了：

1. 选择安装方式- 根据你的AI编码平台选择合适的安装命令
2. 启动第一个规划- 使用/plan命令开始你的第一个复杂任务
3. 体验持久化记忆- 观察AI助手如何保持目标一致性
4. 测试恢复能力- 故意使用/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