Planning with Files：像 Manus AI 一样工作的 Claude Code 技巧
Planning with Files：像 Manus AI 一样工作的 Claude Code 技巧
GitHub: github.com/OthmanAdi/planning-with-files
背景：Meta 以 20 亿美元收购 Manus AI 的核心工作模式
💡 核心思想
Manus AI 在被 Meta 以 20 亿美元收购前的核心秘诀：Context Engineering（上下文工程）
“Markdown 是我的’磁盘工作内存’。由于我迭代处理信息且活跃上下文有限，Markdown 文件作为笔记的草稿本、进度的检查点、最终交付成果的构建模块。”
—— Manus AI
类比理解
| 概念 | 类比 | 特点 |
|---|---|---|
| 上下文窗口 | RAM | 易失性、容量有限 |
| 文件系统 | 磁盘 | 持久性、容量无限 |
→ 重要信息必须写入磁盘！
🎯 解决的问题
Claude Code（和大多数 AI Agent）存在的问题：
| 问题 | 说明 |
|---|---|
| ❌ 易失性内存 | TodoWrite 工具在上下文重置后消失 |
| ❌ 目标漂移 | 50+ 工具调用后，原始目标被遗忘 |
| ❌ 隐藏错误 | 失败未被记录，导致重复犯错 |
| ❌ 上下文填充 | 所有信息塞进上下文，而非存储起来 |
📁 3-File 模式（核心）
每个复杂任务创建 三个文件：
1. task_plan.md —— 任务规划
- 跟踪任务阶段和进度
- 定义具体执行步骤
- 勾选完成的任务
2. findings.md —— 研究发现
- 存储研究过程中收集的信息
- 记录关键数据和技术细节
- 替代上下文填充
3. progress.md —— 进度日志
- 会话日志和测试结果
- 记录错误和失败
- 追踪尝试次数
🚀 安装与使用
安装方式
方式一：插件安装（推荐）
claude plugins install OthmanAdi/planning-with-files
方式二：Skill 安装（OpenCode 等）
npx skills add github.com/OthmanAdi/planning-with-files --skill planning-with-files
使用命令
安装后，Claude 会自动：
- 在开始复杂任务前创建 task_plan.md
- 在做重大决策前重新阅读计划（PreToolUse hook）
- 在文件写入后提醒你更新状态（PostToolUse hook）
- 将发现存储到 findings.md，而非塞满上下文
- 记录错误供将来参考
- 停止前验证完成度（Stop hook）
手动触发命令：
- /planning-with-files:plan —— 短命令（v2.11.0+，输入 /plan 自动补全）
- /planning-with-files:start —— 原始命令（输入 /planning 自动补全）
- /planning-with-files —— 如果已复制 skills 到本地
🔄 工作流程
最优工作流
- 禁用 auto-compact —— 使用完整上下文窗口
- 在项目中开启新会话
- 运行
/planning-with-files—— 准备开始复杂任务 - 工作直到上下文填满 —— Claude 会警告你
- 运行
/clear开始新会话 - 再次运行
/planning-with-files—— 自动恢复之前进度
禁用 Auto-Compact
在 Claude Code 设置或 .claude/settings.json 中：
{
"autoCompact": false
}
🛡️ 会话恢复功能（v2.2.0+）
当上下文窗口填满并运行 /clear 后，此 skill 会自动恢复未同步的工作。
恢复机制：
1. 检查之前会话数据（存储在 ~/.claude/projects/）
2. 找到上次更新规划文件的时间
3. 提取之后发生的对话（可能丢失的上下文）
4. 显示追赶报告，让你同步规划文件
📋 关键规则
| 规则 | 说明 |
|---|---|
| 先创建计划 | 没有 task_plan.md 绝不开始 |
| 2-Action 规则 | 每 2 次 view/browser 操作后保存发现 |
| 记录所有错误 | 帮助避免重复犯错 |
| 绝不重复失败 | 跟踪尝试次数，改变方法 |
✅ 何时使用 / 何时跳过
使用场景：
- ✅ 多步骤任务（3+ 步骤）
- ✅ 研究任务
- ✅ 构建/创建项目
- ✅ 跨多个工具调用的任务
跳过场景：
- ❌ 简单问题
- ❌ 单文件编辑
- ❌ 快速查询
🔧 多平台支持
| IDE/工具 | 状态 | 说明 |
|---|---|---|
| Claude Code | ✅ 完整支持 | 原生插件 |
| Gemini CLI | ✅ 完整支持 | Agent Skills |
| Cursor | ✅ 完整支持 | Skills |
| OpenCode | ✅ 完整支持 | Personal/Project Skill |
| Kilo Code | ✅ 完整支持 | Skills |
| Codex | ✅ 完整支持 | Personal Skill |
| Continue | ✅ 完整支持 | Skills + Prompt files |
| Kiro | ✅ 完整支持 | Steering Files |
| Moltbot | ✅ 完整支持 | Workspace/Local Skills |
💎 为什么这个技巧有效？
用户反馈： “我测试了所有 Claude Code skills，这一个碾压其他所有。它 99% 的时间都能完美完成每个功能，即使复杂的也不例外。如果你不用它，就是在放弃优势。”
核心优势：
1. 持续的上下文提醒 —— 通过文件让 AI 持续回顾目标和进度
2. 几乎零漂移 —— 计划被完美执行
3. 第一次就成功 —— 虽然消耗更多 token，但一次就搞定
📚 Manus 原则总结
| 原则 | 实现方式 |
|---|---|
| 文件系统作为内存 | 存储在文件中，而非上下文中 |
| 注意力操控 | 决策前重新阅读计划（hooks） |
| 错误持久化 | 在计划文件中记录失败 |
| 目标跟踪 | 复选框显示进度 |
| 完成验证 | Stop hook 检查所有阶段 |
🔗 相关资源
- GitHub: https://github.com/OthmanAdi/planning-with-files
- Manus 架构分析: Context Engineering for AI Agents
- 新闻: Meta 20 亿美元收购 Manus
整理时间：2026-02-02