关于 planning-with-files
Planning with Files 是通过持久化 Markdown 文件管理复杂任务的工作流技能。它用计划、研究笔记和交付文件跟踪进度,并整理工作上下文。
主要功能
- 01在 task_plan.md 中跟踪任务阶段
- 02在 notes.md 中保存研究内容
- 03单独创建交付文件
- 04重大决策前重新查看计划
- 05记录错误并更新状态
适用场景
- 01组织多步骤研究任务
- 02跟踪构建过程的进度
- 03在多次工具调用间保留研究结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ op0ai/ claude-skills --skill planning-with-files安装后在 Claude Code 中输入/planning-with-files确认已加载。
附带文件examples.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