任务模板速查表
把 Claude Code 高频任务模板集中到一页:只读分析、Plan Mode、修 Bug、新增页面、补文档、补测试、验收、代码审查、发布检查和交接总结。
这页适合边用边查。复制模板后,把【变量】替换成真实信息,不要原样发送。
模板不是咒语。真正重要的是把目标、范围、限制和验收说清楚。模板只负责提醒这些要素不要漏。
只读分析
请只读分析当前项目,不要修改文件。 请输出: 1. 项目用途。 2. 技术栈。 3. 关键目录和入口。 4. 已确认的启动、构建、测试方式。 5. 风险文件或不要随便改的目录。 6. 第一个低风险任务建议。
适合:第一次打开项目、上下文乱了、接手旧项目、进入真实项目之前。
Plan Mode
/plan 任务目标: 【写清楚目标】 限制: 1. 先只读分析。 2. 不要修改文件。 3. 不要安装依赖。 4. 不要提交 Git。 请输出最小方案、修改范围、风险和验收方式。
适合:多文件任务、Bug 原因不清、接口/权限/配置/数据库相关任务。
修 Bug
/plan 请修复这个 Bug,但先不要修改文件。 现象: 【现在发生什么】 复现步骤: 1. 【步骤一】 2. 【步骤二】 期望: 【应该发生什么】 请先定位原因,给出最小修复方案。
如果没有复现步骤,先用:
我现在没有完整复现步骤。 请先帮我整理需要补充的信息,不要修改文件。
新增页面
/plan 请新增一个页面,但先只读分析。 页面目标: 【这个页面解决什么】 页面路径: 【希望路径】 要求: 1. 复用现有样式。 2. 不新增依赖。 3. 必要时更新导航。 4. 设置 title 和 description。 5. 修改后检查 clean URL 和移动端。
适合:新增教程页、落地页、后台低风险页面。涉及权限或数据加载时,先拆成接口和页面两个任务。
补文档
请补充文档,但先读取项目事实。 要求: 1. 不编造不存在的命令。 2. 不写未确认的部署方式。 3. 不暴露密钥或内部地址。 4. 标出哪些内容来自项目文件。 5. 新增文档后检查导航和学习路线。
适合:README、使用说明、交接总结、教程文档、部署说明。
补测试
/plan 请先分析项目测试方式,不要直接写测试。 请输出: 1. 测试框架。 2. 测试文件位置。 3. 现有命名和断言风格。 4. 本次最小测试断言。 5. 如何运行相关测试。
适合:Bug 修复、接口逻辑、权限判断、重构保护网。不适合纯文案和低风险样式。
验收
/verify 请验证本次修改是否满足原始目标。 请输出: 1. 原始目标。 2. 修改文件。 3. 已执行检查。 4. 通过项。 5. 未验证项。 6. 是否建议进入 /code-review。
代码审查
/code-review 请审查本次未提交改动。 优先看: 1. Bug。 2. 安全风险。 3. 越界修改。 4. 漏测。 5. 敏感信息。 按严重程度输出。
提交前检查
请做提交前检查,但不要提交 Git。 请检查: 1. 当前 Git 状态。 2. 本次应提交文件。 3. 不应提交文件。 4. 是否有密钥或隐私。 5. 建议提交信息。
发布前检查
请做发布前检查,但不要执行发布。 请输出: 1. 发布阻塞项。 2. 需要人工确认项。 3. 回滚方案。 4. 发布后验收清单。 5. 是否建议发布。
交接总结
请生成任务交接总结。 请包含: 1. 原始目标。 2. 已完成内容。 3. 修改文件。 4. 已验证内容。 5. 未验证风险。 6. 下一步最小动作。
使用原则
- 先替换变量。
- 不确定就先
/plan。 - 改完一定
/verify。 - 提交前一定检查 Git 和敏感信息。
再补三条:
- 高风险任务先只读,不要直接执行。
- 多文件任务先拆阶段,不要一口气改完。
- 模板发出后,如果 CC 扩大范围,要立刻收窄。
模板选择表
| 当前问题 | 用哪个模板 |
|---|---|
| 不知道项目是什么 | 只读分析 |
| 不知道怎么改 | Plan Mode |
| 页面或接口坏了 | 修 Bug |
| 要加一篇文章或页面 | 新增页面 / 补文档 |
| 要证明修复不会复发 | 补测试 |
| 改完不知道行不行 | 验收 |
| 准备提交 | 代码审查 + 提交前检查 |
| 准备上线 | 发布前检查 |
模板用错时怎么收回
如果已经发了一个太宽泛的模板,可以这样收回来:
刚才的任务范围太大,请暂停。 请重新按下面要求处理: 1. 只保留当前最小目标。 2. 不继续修改文件。 3. 列出已经理解的范围。 4. 标出可能越界的部分。 5. 重新给出可控计划。
最推荐保存的 3 个模板
新手最先保存这三个就够:
| 模板 | 使用场景 |
|---|---|
| 只读分析 | 第一次进项目、上下文乱、接手老项目 |
| Plan Mode | 任何不确定、多文件、高风险任务 |
| 验收 | 每次改完后确认结果 |
先把这三个用熟,再慢慢加 Bug、测试、发布、交接模板。