文件规划

像Manus一样工作：使用持久化的markdown文件作为你的“磁盘工作记忆”。

第一步：恢复上下文 (v2.2.0)

在进行任何其他操作之前，检查规划文件是否存在并读取它们：

1. 如果task_plan.md存在，立即读取task_plan.md、progress.md和findings.md。
2. 然后检查前一次会话中未同步的上下文：

# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files\scripts\session-catchup.py" (Get-Location)

如果补丁报告显示有未同步的上下文：

1. 运行git diff --stat以查看实际的代码更改
2. 读取当前的规划文件
3. 基于补丁报告和git差异更新规划文件
4. 然后继续任务

重要：文件存放位置

• 模板位于${CLAUDE_PLUGIN_ROOT}/templates/
• 您的规划文件存放在您的项目目录中

快速开始

在任何复杂任务之前：

1. 创建task_plan.md— 使用templates/task_plan.md作为参考
2. 创建findings.md— 使用templates/findings.md作为参考
3. 创建progress.md— 以templates/progress.md为参考
4. 决策前重读计划— 刷新注意力窗口中的目标
5. 每个阶段后更新— 标记完成，记录错误

注意：规划文件应放在项目根目录，而非技能安装文件夹。

核心模式

上下文窗口 = 内存（易失，有限）
文件系统 = 硬盘（持久，无限）

→ 任何重要内容都应写入硬盘。

文件用途

关键规则

1. 先制定计划

切勿在未创建task_plan.md文件的情况下开始复杂任务。没有商量余地。

2. 双操作规则

"每进行两次查看/浏览/搜索操作后，必须立即将关键发现保存到文本文件中。"

这可以防止视觉/多模态信息丢失。

3. 决定前先阅读

在做重大决定之前，先阅读计划文件。这能确保目标保持在你的注意力窗口内。

4. 行动后更新

完成任何阶段后：

• 标记阶段状态：进行中→已完成
• 记录遇到的任何错误
• 注明创建/修改的文件

5. 记录所有错误

每个错误都要记录在计划文件中。这有助于积累知识并避免重复犯错。

## 遇到的错误
| 错误 | 尝试次数 | 解决方案 |
|-------|---------|------------|
| FileNotFoundError | 1 | 创建了默认配置 |
| API 超时 | 2 | 添加了重试逻辑 |

6. 绝不重复失败

如果操作失败：
    下一个操作 ≠ 相同操作

记录你尝试过的内容。改变方法。

7. 完成后继续

当所有阶段都已完成，但用户要求额外工作时：

• 向task_plan.md（例如，第6阶段，第7阶段）
• 在progress.md
• 中记录一个新的会话条目

照常继续规划工作流程

三击错误协议

尝试 1：诊断与修复 → 仔细阅读错误信息 → 确定根本原因 → 应用针对性修复 尝试 2：替代方法 → 相同的错误？尝试不同的方法 → 不同的工具？不同的库？ → 切勿重复完全相同的失败操作 尝试 3：更广泛的重新思考 → 质疑假设 → 寻找解决方案 → 考虑更新计划 3次失败后：上报给用户 → 解释你尝试了什么 → 分享具体的错误信息 → 请求指导

5个问题的重启测试

如果你能回答这些问题，说明你的上下文管理很扎实：

何时使用此模式

适用于：

• 多步骤任务（3步以上）
• 研究任务
• 构建/创建项目
• 涉及多次工具调用的任务
• 任何需要组织的任务

跳过适用于：

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

模板

复制这些模板以开始：

• templates/task_plan.md— 阶段追踪
• templates/findings.md— 研究存储
• templates/progress.md— 会话记录

脚本

用于自动化的辅助脚本：

• scripts/init-session.sh— 初始化所有规划文件
• scripts/check-complete.sh— 验证所有阶段完成
• scripts/session-catchup.py— 从之前会话恢复上下文（v2.2.0）

高级主题

• Manus 原则：参见reference.md
• 真实示例：参见examples.md

安全边界

此技能使用 PreToolUse 钩子在每次工具调用前重新读取task_plan.md写入的内容task_plan.md会被反复注入上下文——这使其成为间接提示注入的高价值目标。

反模式