mcpField
P
planning-with-files

planning-with-files

github.com/op0aiAgent 工作流1758 次安装41 周前更新
代码仓库

关于 planning-with-files

Planning with Files 是通过持久化 Markdown 文件管理复杂任务的工作流技能。它用计划、研究笔记和交付文件跟踪进度,并整理工作上下文。

主要功能

  1. 01在 task_plan.md 中跟踪任务阶段
  2. 02在 notes.md 中保存研究内容
  3. 03单独创建交付文件
  4. 04重大决策前重新查看计划
  5. 05记录错误并更新状态

适用场景

  1. 01组织多步骤研究任务
  2. 02跟踪构建过程的进度
  3. 03在多次工具调用间保留研究结果

安装

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

$npx skills add https://github.com/op0ai/claude-skills --skill planning-with-files

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

附带文件examples.mdreference.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