关于 planning-with-files
Planning with Files 是面向 Claude Code 等 AI Agent 的技能，通过持久化 Markdown 文件组织复杂任务。三文件模式分别记录任务计划、研究笔记和最终交付物，便于跨多次工具调用保留进度。
主要功能
- 01三文件规划模式
- 02使用 Markdown 持久跟踪进度
- 03分开保存研究笔记与交付物
- 04记录失败并跟踪目标
- 05提供工作流适用场景指引
适用场景
- 01组织需要多次工具调用的研究
- 02在项目构建中跟踪各阶段
- 03在上下文重置后保留研究发现
- 04根据保存的研究笔记生成交付物
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/planning-with-files确认已加载。
附带文件README.md
详细介绍
使用文件进行规划
“像 Manus 一样工作”——使用持久化 Markdown 文件进行规划、进度跟踪和知识存储。
描述
这项技能可将你的工作流转换为使用持久化 Markdown 文件进行规划和进度跟踪。
问题所在
Claude Code（以及大多数 AI Agent）面临以下问题：
- 易失性记忆——上下文重置后，TodoWrite 工具就会消失
- 目标偏移——经过多次工具调用后，最初的目标会被遗忘
- 错误隐而不见——失败没有被记录，导致错误反复出现
- 上下文塞满——所有内容都挤在上下文里，而不是存储起来
解决方案：三文件模式
对于每项复杂任务，都创建三个文件：
task_plan.md → Track phases and progress
notes.md → Store research and findings
[deliverable].md → Final output
工作流循环
1. Create task_plan.md with goal and phases
2. Research → save to notes.md → update task_plan.md
3. Read notes.md → create deliverable → update task_plan.md
4. Deliver final output
适用场景
适用于：
- 多步骤任务（3 步以上）
- 研究任务
- 构建或创建项目
- 涉及多次工具调用的任务
- 任何需要组织规划的任务
不适用于：
- 简单问题
- 单文件编辑
- 快速查询
安装
此技能通常安装在 ~/.claude/skills/planning-with-files/。
从此代码库安装：
ln -s /path/to/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files
如果你更喜欢独立工作流，请参阅“链接”部分中的上游代码库。
Manus 原则
| 原则 | 实现方式 |
|---|---|
| 将文件系统用作记忆 | 存储在文件中，而非上下文中 |
| 注意力引导 | 做决定前重新阅读计划 |
| 错误持久化 | 在计划文件中记录失败 |
| 目标跟踪 | 使用复选框显示进度 |
| 仅追加上下文 | 永不修改历史记录 |
示例
你：“研究 TypeScript 的优势并撰写摘要”
Claude 创建：
# Task Plan: TypeScript Benefits Research
## Goal
Create a research summary on TypeScript benefits.
## Phases
- [x] Phase 1: Create plan ✓
- [ ] Phase 2: Research and gather sources (CURRENT)
- [ ] Phase 3: Synthesize findings
- [ ] Phase 4: Deliver summary
## Status
**Currently in Phase 2** - Searching for sources
链接
评论
支持 Markdown