任务模板速查表

把 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 Mode
页面或接口坏了修 Bug
要加一篇文章或页面新增页面 / 补文档
要证明修复不会复发补测试
改完不知道行不行验收
准备提交代码审查 + 提交前检查
准备上线发布前检查

模板用错时怎么收回

如果已经发了一个太宽泛的模板,可以这样收回来:

刚才的任务范围太大,请暂停。

请重新按下面要求处理:
1. 只保留当前最小目标。
2. 不继续修改文件。
3. 列出已经理解的范围。
4. 标出可能越界的部分。
5. 重新给出可控计划。

最推荐保存的 3 个模板

新手最先保存这三个就够:

模板使用场景
只读分析第一次进项目、上下文乱、接手老项目
Plan Mode任何不确定、多文件、高风险任务
验收每次改完后确认结果

先把这三个用熟,再慢慢加 Bug、测试、发布、交接模板。