Back to list
Gavinchen92

planning-with-files

by Gavinchen92

0🍴 0📅 Jan 7, 2026

SKILL.md


name: planning-with-files description: Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Use when starting complex tasks, multi-step projects, research tasks, or when the user mentions planning, organizing work, tracking progress, or wants structured output.

使用文件进行规划

使用持久化的 markdown 文件作为"磁盘上的工作记忆"。

快速开始

在执行任何复杂任务之前:

  1. 在工作目录创建docs/YYYY-MM-DD-[task_name]文件夹
  2. 在对应目录中创建 task_plan.md
  3. 使用复选框定义阶段
  4. 每个阶段后更新 - 标记 [x] 并更改状态
  5. 决策前先读取 - 在注意力窗口中刷新目标

三文件模式

对于每个非平凡的任务,创建三个文件:

文件用途何时更新
task_plan.md跟踪阶段和进度每个阶段后
notes.md存储发现和研究研究期间
[deliverable].md最终输出完成时

核心工作流

Loop 1: 创建task_plan.md文件,包含目标和阶段
Loop 2: 研究 → 保存到 notes.md → 更新 task_plan.md
Loop 3: 阅读 notes.md → 创建交付物 → 更新 task_plan.md
Loop 4: 交付最终输出

循环的详细说明

在每个主要操作之前:

Read task_plan.md  # 在注意力窗口中刷新目标

在每个阶段之后:

Edit task_plan.md  # 标记 [x],更新状态

存储信息时:

Write notes.md     # 不要将上下文塞满,存储在文件中

task_plan.md 模板

对于任何复杂任务,首先创建此文件:

# 任务计划: [简要描述任务]

## 目标
[用一句话描述最终状态]

## 阶段
- [ ] 阶段 1: 计划和设置
- [ ] 阶段 2: 研究/收集信息
- [ ] 阶段 3: 执行/构建
- [ ] 阶段 4: 审查和交付

## 关键问题
1. [要回答的问题]
2. [要回答的问题]

## 决策
- [决策]: [理由]
## 遇到的错误
- [错误]: [解决方案]

## 状态
**当前阶段 X** - [我现在正在做什么]

notes.md 模板

用于研究和发现:

# 笔记: [主题]

## 来源

### 来源 1: [名称]
- URL: [链接]
- 关键点:
  - [发现]
  - [发现]

## 综合发现

### [类别]
- [发现]
- [发现]

关键规则

1. 始终先创建计划

在没有 task_plan.md 的情况下永远不要开始复杂任务。这是不可协商的。

2. 决策前先读取

在做任何重大决策之前,读取计划文件。这会将目标保持在你的注意力窗口中。

3. 行动后更新

完成任何阶段后,立即更新计划文件:

  • 用 [x] 标记已完成的阶段
  • 更新状态部分
  • 记录遇到的任何错误

4. 存储,不要塞满

大型输出放入文件,而不是上下文。只在工作记忆中保留路径。

5. 记录所有错误

每个错误都记录在"遇到的错误"部分。这为将来的任务建立知识。

何时使用此模式

使用三文件模式的情况:

  • 多步骤任务(3+ 步骤)
  • 研究任务
  • 构建/创建某物
  • 跨越多个工具调用的任务
  • 任何需要组织的事情

跳过的情况:

  • 简单问题
  • 单文件编辑
  • 快速查找

要避免的反模式

不要做改为这样做
使用 TodoWrite 持久化创建 task_plan.md 文件
只陈述目标一次就忘记在每次决策前重新读取计划
隐藏错误并重试将错误记录到计划文件
将所有内容塞进上下文将大型内容存储在文件中
立即开始执行首先创建计划文件

高级模式

参见 reference.md

  • 注意力操纵技术
  • 错误恢复模式
  • 来自 Manus 的上下文优化

参见 examples.md

  • 真实任务示例
  • 复杂工作流模式

Score

Total Score

35/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

0/5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon