关联主题:: Claude Skills说明(2026.01.13)
同级:: 2026-01-13_星期二
下一级::
项目信息
- GitHub: https://github.com/OthmanAdi/planning-with-files
- 版本: v2.0.0
- 作者: Ahmad Othman Ammar Adi
- 灵感来源: Manus AI（被 Meta 以 20 亿美元收购的 AI Agent 公司）
这是什么？
Planning with Files 是一个 Claude Code 技能（Skill），它实现了 Manus AI 的上下文工程模式。
2025 年 12 月，Meta 以 20 亿美元收购了 Manus AI。这家公司仅用 8 个月就实现了 1 亿美元以上的收入。他们的核心秘密是什么？上下文工程（Context Engineering）。
“Markdown 是我磁盘上的’工作记忆’。由于我迭代处理信息且活动上下文有限，Markdown 文件充当笔记草稿、进度检查点和最终交付物的构建块。”
— Manus AI
解决什么问题？
Claude Code（以及大多数 AI Agent）存在以下问题：
| 问题 | 说明 |
|---|---|
| 易失记忆 | TodoWrite 工具在上下文重置时消失 |
| 目标漂移 | 50+ 次工具调用后，原始目标被遗忘 |
| 隐藏错误 | 失败没被追踪，同样的错误反复发生 |
| 上下文堆积 | 所有信息都塞进上下文而不是存储 |
核心理念
上下文窗口 = RAM（易失、有限）
文件系统 = 硬盘（持久、无限）
→ 重要的东西都写入文件
解决方案：3 文件模式
每个复杂任务创建 三个 Markdown 文件：
task_plan.md → 追踪阶段和进度
findings.md → 存储研究和发现
progress.md → 会话日志和测试结果
各文件职责
| 文件 | 用途 | 内容示例 |
|---|---|---|
task_plan.md | 任务分解与进度 | 阶段划分、检查框、完成状态 |
findings.md | 研究发现存储 | API 文档摘要、代码片段、关键信息 |
progress.md | 会话日志 | 测试结果、错误记录、时间线 |
v2.0 新特性
- Hooks 集成 — 自动重读计划、完成验证
- 模板系统 — 结构化的 task_plan、findings、progress 模板
- 辅助脚本 — 初始化和完成检查脚本
- 2-Action 规则 — 每 2 次浏览/查看操作后保存发现
- 3-Strike 协议 — 失败追踪机制，避免重复错误
- 5-Question 重启测试 — 验证任务完成度
Manus 六大原则
| 原则 | 实现方式 |
|---|---|
| 文件系统即记忆 | 存储在文件中，而非上下文 |
| 注意力操控 | 通过 Hooks 在决策前重读计划 |
| 错误持久化 | 在计划文件中记录失败 |
| 目标追踪 | 检查框显示进度 |
| 完成验证 | Stop hook 检查所有阶段 |
| 保留错误记录 | 错误信息帮助避免重复 |
安装方法
Claude Code 插件安装（推荐）
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files手动安装
# 克隆仓库
git clone https://github.com/OthmanAdi/planning-with-files.git
# 复制到 skills 目录
cp -r planning-with-files/skills/planning-with-files ~/.claude/skills/一行命令安装
curl -L https://github.com/OthmanAdi/planning-with-files/archive/master.tar.gz | tar -xzv --strip-components=2 "planning-with-files-master/skills/planning-with-files"
mv planning-with-files ~/.claude/skills/使用场景
✅ 适合使用
- 多步骤任务（3+ 步骤）
- 研究类任务
- 项目构建/创建
- 跨多次工具调用的任务
- 任何需要组织规划的工作
❌ 不需要使用
- 简单问答
- 单文件编辑
- 快速查询
核心规则
- 先创建计划 — 复杂任务必须先有
task_plan.md - 2-Action 规则 — 每 2 次查看/浏览操作后保存发现
- 记录所有错误 — 帮助避免重复
- 不重复失败 — 追踪尝试次数，变换方法
与 Superpowers 的关系
| 技能集 | 侧重点 |
|---|---|
| Superpowers | TDD、代码审查、Git 工作流、调试 |
| Planning with Files | 长任务记忆管理、进度追踪、上下文工程 |
两者可以配合使用：
- 用 Planning with Files 管理整体任务规划
- 用 Superpowers 指导具体的开发实践