---

name: planning-with-files description: "像 Manus 一样工作：使用持久化 markdown 文件作为你的"磁盘上的工作记忆"。" risk: unknown source: community date_added: "2026-02-27"

文件规划

像 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 作为参考
2. 在项目中创建 findings.md — 使用 templates/findings.md 作为参考
3. 在项目中创建 progress.md — 使用 templates/progress.md 作为参考
4. 决策前重新阅读计划 — 在注意力窗口中刷新目标
5. 每个阶段后更新 — 标记完成，记录错误

注意： 所有三个规划文件应创建在当前工作目录（项目根目录），而非技能安装文件夹。

核心模式

上下文窗口 = RAM（易失、有限）
文件系统 = 磁盘（持久、无限）

→ 任何重要的东西都写入磁盘。

文件用途

| 文件 | 用途 | 何时更新 | |------|------|----------| | task_plan.md | 阶段、进度、决策 | 每个阶段后 | | findings.md | 研究、发现 | 任何发现后 | | progress.md | 会话日志、测试结果 | 整个会话中 |

关键规则

1. 先创建计划

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

2. 两步操作规则

"每 2 次查看/浏览器/搜索操作后，立即将关键发现保存到文本文件。"

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

3. 决策前阅读

在重大决策前，阅读计划文件。这将目标保持在注意力窗口中。

4. 行动后更新

完成任何阶段后：

• 标记阶段状态：in_progress → complete
• 记录遇到的任何错误
• 记录创建/修改的文件

5. 记录所有错误

每个错误都进入计划文件。这积累知识并防止重复。

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

6. 永不重复失败

if action_failed:
    next_action != same_action

追踪你尝试过的。改变方法。

三次失败协议

尝试 1：诊断和修复
  → 仔细阅读错误
  → 识别根因
  → 应用针对性修复

尝试 2：替代方法
  → 同样的错误？尝试不同方法
  → 不同工具？不同库？
  → 永远不要重复完全相同的失败操作

尝试 3：更广泛的重新思考
  → 质疑假设
  → 搜索解决方案
  → 考虑更新计划

3 次失败后：升级给用户
  → 解释你尝试了什么
  → 分享具体错误
  → 建议替代方案

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来要求澄清。