使用技巧

Plan Mode计划模式

# 计划模式（Plan Mode）和 Superpowers Skills

这是进阶技巧：对于任何超过 3 步的任务，不要直接让 Claude/ChatGPT 开始，先让它出一份 plan，你 review 确认后再执行。

# 为什么 Plan 模式重要

不 plan 直接开始的问题：

  1. Claude/ChatGPT 猜错方向 → 改 50 行 → 你说"不对应该 xxx" → Claude/ChatGPT 返工 → 再改 50 行
  2. 返工的 token 消耗 = 做一次正确的 3 倍（因为要"解释现有代码 + 分析怎么改 + 重新写"）
  3. 如果你想先 review 思路再实现，直接进 plan mode 成本低得多

先 plan 的好处：

  1. 在 1000 token 的 plan 阶段对齐意图
  2. 你在 plan 阶段发现"哦应该是 xxx"，改 plan 文本比改代码便宜 100 倍
  3. Claude/ChatGPT 有完整蓝图，执行时少走弯路

# 怎么进 Plan Mode

Claude/ChatGPT有专门的 Plan Mode：

  • 按 Shift + Tab 切换进入 Plan Mode（UI 会显示 “plan mode on”）
  • 这时候 Claude/ChatGPT 只会规划，不会改任何文件
  • 看 Claude/ChatGPT 的 plan，满意了按 Enter 或特定按键让它执行
  • 不满意就说"改成 xxx" 调整 plan

# Superpowers Skills

Superpowers 是一组常用 skill。可以把一些复杂工作流自动化。和本帮助中心相关的几个：

# brainstorming

把模糊的想法变成清晰的 design spec。流程：

  1. Claude/ChatGPT 一次一个问题和你澄清
  2. 提出 2-3 个方案让你选
  3. 分节呈现设计，你逐节 approve
  4. 写成 spec 文档存到 docs/superpowers/specs/

适合：新 feature / 新架构 / 任何你自己也没完全想清楚的事。

启动：说 “用 brainstorming skill 和我设计 xxx” 即可。

# writing-plans

把一份 spec 转成可执行的 bite-sized task list，每个 task 包含：

  • 要改哪些文件（精确路径）
  • 要写什么测试
  • 怎么验证 pass
  • Commit message 模板

适合：brainstorming 完有 spec 后的下一步，或者已经有需求文档想分步执行。

# subagent-driven-development

大 plan 的执行引擎。每个 task 派一个独立的 subagent 来做，主会话只管协调和 review：

  1. 派 implementer subagent 执行 task → 报告
  2. 派 spec compliance reviewer → 确认完整匹配 spec
  3. 派 code quality reviewer → 查问题
  4. 所有通过后进下一个 task

优点：主会话不被每个 task 的细节塞满，能处理 30+ task 的大 plan。

# 反面例子

❌ 不好：

“把这个项目的 authentication 模块整个重构一遍”

Claude/ChatGPT 会：

  • 读所有 auth 相关文件（消耗 20K token）
  • 开始改第一个文件（消耗 5K token）
  • 你发现不对：“应该先抽公共逻辑”
  • Claude/ChatGPT 撤回改动、重新读、重新规划（消耗 15K token）
  • 开始抽公共逻辑…（消耗 10K）
  • 你发现"其实想加 OAuth"
  • 又一轮 20K token 的返工

累计 70K+ token，还可能反复修改 4-5 次。

✅ 好：

“我想重构 authentication 模块。先用 brainstorming skill 帮我设计完整方案：支持邮箱密码、Google OAuth、magic link 三种方式；token 存 httpOnly cookie；有 rate limit；现有 users 表不动。”

Claude 进 brainstorming，问完问题，出 spec（约 15K token）。你 review 完说"对"，然后调 writing-plans 出实施计划（10K token）。执行按计划一个个来（40K token，但都是"对的"token，无返工）。

累计 65K token，和乱做差不多，但结果正确、不返工、你能在每个阶段 interrupt 调整。

# 什么时候可以跳过 Plan Mode

  • 改 1-2 行代码
  • 修 typo
  • 文件路径重命名
  • 加一个 import
  • Claude 已经在 plan 模式完成了 plan 正在执行中

凡是会改 3 个以上文件 / 引入新依赖 / 改公共模块 → 都值得先 plan。