← Back to list

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 文件作为"磁盘上的工作记忆"。
快速开始
在执行任何复杂任务之前:
- 在工作目录创建
docs/YYYY-MM-DD-[task_name]文件夹 - 在对应目录中创建
task_plan.md - 使用复选框定义阶段
- 每个阶段后更新 - 标记 [x] 并更改状态
- 决策前先读取 - 在注意力窗口中刷新目标
三文件模式
对于每个非平凡的任务,创建三个文件:
| 文件 | 用途 | 何时更新 |
|---|---|---|
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