真实项目接入前检查

从练习项目进入真实项目前,不要直接让 Claude Code 修改代码。先检查 Git 状态、密钥边界、权限模式、测试方式、回滚方式和团队规则。

练习项目跑通以后,下一步不是马上让 CC 改真实业务代码,而是先做接入前检查。

真实项目通常有更多风险:历史改动、密钥、生产配置、数据库、多人协作、发布流程。先把边界说清楚,后面才不会越改越乱。

接入前先做只读检查

请只读检查当前项目是否适合让 Claude Code 参与开发。

要求:
1. 不要创建、修改、删除任何文件。
2. 检查当前 Git 状态。
3. 检查是否存在真实密钥、生产配置或敏感数据风险。
4. 检查项目是否有 README、启动脚本、测试或构建方式。
5. 检查是否有 CLAUDE.md 或团队规则。
6. 给出第一个适合 CC 参与的低风险任务建议。

真实项目接入清单

检查项要确认什么
Git 状态是否有未提交改动,来源是否清楚
密钥边界.env、Token、证书、生产配置是否需要避开
权限模式是否先用 plandefault
测试方式是否有测试、构建、Lint 或人工验收方式
回滚方式改错后如何撤回本次改动
团队规则是否有代码规范、提交规范、发布流程

这张表不要只看一遍。第一次接入真实项目时,可以让 CC 逐项输出“已确认 / 未确认 / 需要人工确认”:

请按真实项目接入清单逐项检查。

每一项输出:
1. 当前结论。
2. 证据来自哪个文件或命令结果。
3. 是否还需要人工确认。
4. 如果未确认,继续开发会有什么风险。

没有证据的结论,不要当成已确认。

第一个真实项目任务怎么选

适合:

不适合:

真实项目风险分级

风险等级任务例子建议
文档、注释、小文案、非核心样式可以作为第一批任务
普通页面、小接口、明确 Bug先 Plan Mode,再小步修改
登录、权限、订单、数据处理只读分析和严格验收
极高生产数据、部署、支付、回滚必须人工确认,不让 CC 独立执行

真实项目里,任务风险比任务大小更重要。一个只改 1 行的生产配置,也可能比改 5 个文档文件危险得多。

第一次不要证明 CC 很强

第一次接入真实项目,目标不是让 CC 一口气完成大需求,而是验证三件事:

所以第一次任务越小越好。小任务跑顺了,再逐步进入真实需求;小任务都跑不顺,就说明上下文、规则或项目环境还没准备好。

让 CC 选择低风险入口

请基于当前项目,推荐 3 个适合 Claude Code 参与的低风险任务。

要求:
1. 每个任务最多影响 1 到 3 个文件。
2. 不涉及密钥、数据库、支付、权限、生产配置。
3. 每个任务都要有验收方式。
4. 如果没有合适任务,请建议继续只读分析。

工作区不干净怎么办

真实项目里经常已经有别人或自己留下的改动。不要让 CC 直接覆盖。

当前工作区可能不干净,请先只读分类。

请输出:
1. 当前修改文件清单。
2. 哪些可能是用户已有改动。
3. 哪些可能和本次任务相关。
4. 是否建议先暂停新任务。
5. 不要执行 git reset、checkout、clean 或删除操作。

接入后的第一条规则

真实项目里,先保守,再逐步放开:

阶段推荐做法
第一次接入只读分析
第一次修改小范围、低风险、逐步审批
稳定后用 Plan Mode 处理复杂任务
团队共用沉淀 CLAUDE.md、Skill、Hook

接入后沉淀什么

真实项目第一次跑通后,不要把经验只留在聊天里。可以让 CC 整理成长期规则草稿:

请基于本次真实项目接入经验,整理可沉淀规则。

请分成:
1. 适合写进 CLAUDE.md 的项目事实。
2. 适合做成 Skill 的重复流程。
3. 适合用 Hook 提醒的安全边界。
4. 只适合留在本次任务里的临时信息。

不要直接写入文件,先给草稿。

接入记录模板

真实项目第一次接入后,可以保留一份记录:

项目名称:
接入日期:
接入目标:

已确认:
- Git 状态:
- 启动方式:
- 测试/构建方式:
- 密钥边界:
- 权限模式:

第一次任务:
修改文件:
验收方式:
发现的问题:
后续要沉淀到 CLAUDE.md 的内容:

这份记录以后给团队成员看,比聊天记录更清楚。

接入失败时怎么退出

如果真实项目不适合继续,不要硬做:

当前真实项目接入风险较高,请先退出到安全状态。

请输出:
1. 不建议继续的原因。
2. 当前是否有文件被修改。
3. 是否需要恢复或保留当前 diff。
4. 建议回到哪个低风险练习任务。
5. 下次接入前要补什么条件。

验收结果