CCClaude Code中文喂饭教程

实战：提交前检查

Claude Code 提交前检查教程：提交前不要让 CC 自动提交，先确认 Git 状态、应提交文件、敏感信息和提交说明。

直接复制

提交前检查不是让 CC 替你提交，而是让它帮你确认：这次改动是否干净、是否安全、是否有证据证明完成。

请做提交前检查，但不要提交 Git。

要求：
1. 检查当前 Git 状态。
2. 列出本次修改文件。
3. 判断是否有无关文件变化。
4. 检查是否包含 API Key、Token、密码或隐私信息。
5. 回顾本次任务验收是否完成。
6. 如果适合提交，请生成一条不夸大的提交说明。

请最后告诉我：
- 是否建议提交：
- 提交前还要人工确认什么：
- 建议提交信息：

提交前要看什么

提交前检查的核心是“能不能把这次改动作为一个干净提交交出去”。它不是继续开发，也不是自动提交。

检查项通过标准
文件范围每个文件都能解释为什么属于本次任务
敏感信息没有密钥、账号、Token、真实隐私数据
验收证据/verify 或最小检查已经完成
审查结论/code-review 没有阻塞问题
提交说明准确描述实际改动，不夸大

让 CC 检查 diff

请审查当前 Git diff，但不要提交。

请告诉我：
1. 本次 diff 涉及哪些文件。
2. 每个文件是否和任务目标相关。
3. 是否有无关改动。
4. 是否有敏感信息。
5. 是否有生成文件或临时文件不应该提交。
6. 是否建议拆成多个提交。

如果 diff 里文件很多，先让 CC 分组：

当前 diff 文件较多，请先分类，不要提交。

请分成：
1. 本次任务核心文件。
2. 测试或文档文件。
3. 配置或构建文件。
4. 生成文件、日志、临时文件。
5. 需要人工确认的文件。

请说明每类是否建议提交。

提交信息模板

请基于本次实际改动生成提交信息。

要求：
1. 不要夸大范围。
2. 不要写“修复所有问题”。
3. 用中文或英文都可以，但要简洁。
4. 如果本次改动包含多类任务，请建议是否拆提交。

输出 3 个候选：
1. 简短版：
2. 规范版：
3. 中文说明版：

提交说明要对应事实：

实际改动合适说法不合适说法
修一个按钮样式修复移动端按钮换行优化全站 UI
新增一篇文档新增 Claude Code 权限说明完善所有教程
修一个接口分支修复订单状态判断重构订单系统
补一个测试补充登录失败测试提升测试覆盖率

不能接受的总结

什么时候不要提交

如果有无关文件

Git 状态里有无关文件，请不要提交。

请帮我分类：
1. 本次任务必须提交的文件。
2. 可能是无关改动的文件。
3. 生成文件、日志、临时文件。
4. 需要我人工确认的文件。

不要删除文件，只给出建议。

如果发现敏感信息，优先停止：

疑似发现敏感信息，请不要提交。

请只做风险说明：
1. 哪个文件可能包含敏感信息。
2. 敏感信息属于哪类：密钥、Token、账号、隐私数据、内部地址。
3. 是否已经进入 Git 暂存区。
4. 建议如何处理。
5. 不要在回复中重复完整敏感内容。

如果只是临时文件或生成文件，也不要让 CC 直接删除：

这些文件可能不该提交，请先分类说明，不要删除。

请判断：
1. 是否是构建产物。
2. 是否是日志或缓存。
3. 是否是截图或临时文件。
4. 是否需要加入忽略规则。
5. 是否需要人工确认后再处理。

是否需要拆提交

一个提交最好只表达一件事。让 CC 帮忙判断：

请判断这次改动是否应该拆成多个提交。

判断依据：
1. 是否包含互不相关的功能。
2. 是否同时包含代码、文档、配置、样式。
3. 是否存在可以独立回滚的部分。
4. 如果建议拆，请给出拆分方案和每个提交说明。
5. 不要执行提交。

最终确认模板

请做最终提交确认。

请输出：
1. 是否建议提交：是 / 否。
2. 必须提交的文件。
3. 不应提交的文件。
4. 已完成的验收。
5. 剩余风险。
6. 推荐提交信息。

最终确认如果是“否”，要让 CC 说清唯一阻塞项：

如果不建议提交，请只列阻塞项。

要求：
1. 不要列一堆泛泛建议。
2. 说明最先要处理的一个问题。
3. 说明处理完后需要重新做哪项检查。

验收结果

下一篇：模板排障