planning-with-files

# 基于文件的规划 像 Manus 一样工作：使用持久化的 Markdown 文件作为你的“磁盘工作记忆”。 ## 重要：文件存放位置 使用此技能时： - **模板**存储在技能目录 `${CLAUDE_PLUGIN_ROOT}/templates/` 中 - **你的计划文件** (`task_plan.md`, `findings.md`, `progress.md`) 应创建在**你的项目目录**中——即你正在工作的文件夹 | 位置 | 存放内容 | |----------|-----------------| | 技能目录 (`${CLAUDE_PLUGIN_ROOT}/`) | 模板、脚本、参考文档 | | 你的项目目录 | `task_plan.md`, `findings.md`, `progress.md` | 这确保了你的计划文件与代码并存，而不是埋在技能安装文件夹中。 ## 快速开始 在进行任何复杂任务之前： 1. **在项目中创建 `task_plan.md`** — 使用 [templates/task_plan.md](templates/task_plan.md) 作为参考 2. **在项目中创建 `findings.md`** — 使用 [templates/findings.md](templates/findings.md) 作为参考 3. **在项目中创建 `progress.md`** — 使用 [templates/progress.md](templates/progress.md) 作为参考 4. **决策前重读计划** — 在注意力窗口中刷新目标 5. **每个阶段后更新** — 标记完成，记录错误 > **注意：** 所有三个计划文件都应创建在当前工作目录（项目根目录）中，而不是技能的安装文件夹中。 ## 核心模式 上下文窗口 = RAM（易失性，有限） 文件系统 = 磁盘（持久性，无限） → 任何重要内容都应写入磁盘。 ## 文件用途 | 文件 | 用途 | 更新时机 | |------|---------|----------------| | `task_plan.md` | 阶段、进度、决策 | 每个阶段后 | | `findings.md` | 研究、发现 | 任何发现后 | | `progress.md` | 会话日志、测试结果 | 会话期间 | ## 关键规则 ### 1. 先创建计划 没有 `task_plan.md` 绝不开始复杂任务。这是不可商量的。 ### 2. 2-动作规则 > "每进行 2 次查看/浏览器/搜索操作后，立即将关键发现保存到文本文件中。" 这可以防止视觉/多模态信息丢失。 ### 3. 决策前阅读 在做出重大决策前，阅读计划文件。这能让目标保持在你的注意力窗口中。 ### 4. 行动后更新 完成任何阶段后： - 标记阶段状态：`in_progress` → `complete` - 记录遇到的任何错误 - 记录创建/修改的文件 ### 5. 记录所有错误 每个错误都要记录在计划文件中。这能积累知识并防止重复错误。