mcpField
P
planning-with-files

planning-with-files

github.com/kv0906Agent 工作流1836 次安装3 周前更新
代码仓库

关于 planning-with-files

Planning with Files 是一种通过持久化 Markdown 文件管理复杂任务的工作流技能。它引导 Agent 用 `task_plan.md` 跟踪阶段、用 `notes.md` 保存研究,并单独编写交付内容,同时要求定期回顾计划和记录错误。

主要功能

  1. 01三文件任务组织模式
  2. 02通过复选框跟踪阶段
  3. 03持久化研究笔记
  4. 04重大决策前回顾计划
  5. 05错误记录与恢复指引

适用场景

  1. 01组织多步骤研究任务
  2. 02跟踪交付物的制作进度
  3. 03在长期任务中保留研究发现
  4. 04记录错误并据此恢复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/kv0906/cc-skills --skill planning-with-files

安装后在 Claude Code 中输入/planning-with-files确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

examples.md
README.md
reference.md

详细介绍

使用文件进行规划

像 Manus 一样工作:使用持久化的 Markdown 文件作为“存储在磁盘上的工作记忆”。

快速开始

开始任何复杂任务之前:

  1. 在工作目录中创建 task_plan.md
  2. 使用复选框定义各个阶段
  3. 每个阶段结束后更新——标记为 [x] 并更改状态
  4. 决策前先阅读——在注意力窗口中刷新目标

三文件模式

对于每项非简单任务,创建三个文件:

文件用途更新时机
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