关于 planning-with-files
Planning with Files 是一种通过持久化 Markdown 文件管理复杂任务的工作流技能。它引导 Agent 用 `task_plan.md` 跟踪阶段、用 `notes.md` 保存研究,并单独编写交付内容,同时要求定期回顾计划和记录错误。
主要功能
- 01三文件任务组织模式
- 02通过复选框跟踪阶段
- 03持久化研究笔记
- 04重大决策前回顾计划
- 05错误记录与恢复指引
适用场景
- 01组织多步骤研究任务
- 02跟踪交付物的制作进度
- 03在长期任务中保留研究发现
- 04记录错误并据此恢复
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ kv0906/ cc-skills --skill planning-with-files安装后在 Claude Code 中输入/planning-with-files确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
examples.mdREADME.mdreference.md详细介绍
使用文件进行规划
像 Manus 一样工作:使用持久化的 Markdown 文件作为“存储在磁盘上的工作记忆”。
快速开始
开始任何复杂任务之前:
- 在工作目录中创建
task_plan.md - 使用复选框定义各个阶段
- 每个阶段结束后更新——标记为 [x] 并更改状态
- 决策前先阅读——在注意力窗口中刷新目标
三文件模式
对于每项非简单任务,创建三个文件:
| 文件 | 用途 | 更新时机 |
|---|---|---|
task_plan.md | 跟踪阶段和进度 | 每个阶段结束后 |
notes.md | 存储发现和研究内容 | 研究期间 |
[deliverable].md | 最终输出 | 完成时 |
核心工作流
Loop 1: Create task_plan.md with goal and phases
Loop 2: Research → save to notes.md → update task_plan.md
Loop 3: Read notes.md → create deliverable → update task_plan.md
Loop 4: Deliver final output
循环详解
每次重大操作之前:
Read task_plan.md # Refresh goals in attention window
每个阶段结束后:
Edit task_plan.md # Mark [x], update status
存储信息时:
Write notes.md # Don't stuff context, store in file
task_plan.md 模板
对于任何复杂任务,首先创建此文件:
# Task Plan: [Brief Description]
## Goal
[One sentence describing the end state]
## Phases
- [ ] Phase 1: Plan and setup
- [ ] Phase 2: Research/gather information
- [ ] Phase 3: Execute/build
- [ ] Phase 4: Review and deliver
## Key Questions
1. [Question to answer]
2. [Question to answer]
## Decisions Made
- [Decision]: [Rationale]
## Errors Encountered
- [Error]: [Resolution]
## Status
**Currently in Phase X** - [What I'm doing now]
notes.md 模板
用于记录研究和发现:
# Notes: [Topic]
## Sources
### Source 1: [Name]
- URL: [link]
- Key points:
- [Finding]
- [Finding]
## Synthesized Findings
### [Category]
- [Finding]
- [Finding]
关键规则
1. 始终先创建计划
没有 task_plan.md,绝不开始复杂任务。这一点不可妥协。
2. 决策前先阅读
在做出任何重大决策之前,先阅读计划文件。这能让目标始终处于注意力窗口中。
3. 操作后立即更新
完成任何阶段后,立即更新计划文件:
- 将已完成的阶段标记为 [x]
- 更新状态部分
- 记录遇到的任何错误
4. 存储,而非塞满上下文
大量输出写入文件,而不是上下文。工作记忆中只保留路径。
5. 记录所有错误
将每个错误都记录在“遇到的错误”部分。这能为未来的任务积累经验。
何时使用此模式
以下情况使用三文件模式:
- 多步骤任务(3 步及以上)
- 研究任务
- 构建或创建某些内容
- 涉及多次工具调用的任务
- 任何需要组织规划的任务
以下情况跳过:
- 简单问题
- 单文件编辑
- 快速查找
应避免的反模式
| 不要 | 改为 |
|---|---|
| 使用 TodoWrite 进行持久化 | 创建 task_plan.md 文件 |
| 只陈述一次目标,然后置之不理 | 每次决策前重新阅读计划 |
| 隐藏错误并重试 | 将错误记录到计划文件中 |
| 把所有内容都塞进上下文 | 将大量内容存入文件 |
| 立即开始执行 | 首先创建计划文件 |
高级模式
请参阅 reference.md,了解:
- 注意力操控技巧
- 错误恢复模式
- Manus 的上下文优化
请参阅 examples.md,了解:
- 真实任务示例
- 复杂工作流模式
评论
支持 Markdown