真实项目接入前检查
从练习项目进入真实项目前,不要直接让 Claude Code 修改代码。先检查 Git 状态、密钥边界、权限模式、测试方式、回滚方式和团队规则。
练习项目跑通以后,下一步不是马上让 CC 改真实业务代码,而是先做接入前检查。
真实项目通常有更多风险:历史改动、密钥、生产配置、数据库、多人协作、发布流程。先把边界说清楚,后面才不会越改越乱。
接入前先做只读检查
请只读检查当前项目是否适合让 Claude Code 参与开发。 要求: 1. 不要创建、修改、删除任何文件。 2. 检查当前 Git 状态。 3. 检查是否存在真实密钥、生产配置或敏感数据风险。 4. 检查项目是否有 README、启动脚本、测试或构建方式。 5. 检查是否有 CLAUDE.md 或团队规则。 6. 给出第一个适合 CC 参与的低风险任务建议。
真实项目接入清单
| 检查项 | 要确认什么 |
|---|---|
| Git 状态 | 是否有未提交改动,来源是否清楚 |
| 密钥边界 | .env、Token、证书、生产配置是否需要避开 |
| 权限模式 | 是否先用 plan 或 default |
| 测试方式 | 是否有测试、构建、Lint 或人工验收方式 |
| 回滚方式 | 改错后如何撤回本次改动 |
| 团队规则 | 是否有代码规范、提交规范、发布流程 |
这张表不要只看一遍。第一次接入真实项目时,可以让 CC 逐项输出“已确认 / 未确认 / 需要人工确认”:
请按真实项目接入清单逐项检查。 每一项输出: 1. 当前结论。 2. 证据来自哪个文件或命令结果。 3. 是否还需要人工确认。 4. 如果未确认,继续开发会有什么风险。
没有证据的结论,不要当成已确认。
第一个真实项目任务怎么选
适合:
- 解释项目结构。
- 补 README 或内部使用说明。
- 修一个明确、低风险、可复现的小 Bug。
- 改一个非核心页面文案或样式。
- 让 CC 做提交前只读审查。
不适合:
- 重构核心模块。
- 改登录、权限、支付、订单、数据库。
- 修改生产配置或部署脚本。
- 直接处理线上事故。
- 自动提交、推送或清理 Git。
真实项目风险分级
| 风险等级 | 任务例子 | 建议 |
|---|---|---|
| 低 | 文档、注释、小文案、非核心样式 | 可以作为第一批任务 |
| 中 | 普通页面、小接口、明确 Bug | 先 Plan Mode,再小步修改 |
| 高 | 登录、权限、订单、数据处理 | 只读分析和严格验收 |
| 极高 | 生产数据、部署、支付、回滚 | 必须人工确认,不让 CC 独立执行 |
真实项目里,任务风险比任务大小更重要。一个只改 1 行的生产配置,也可能比改 5 个文档文件危险得多。
第一次不要证明 CC 很强
第一次接入真实项目,目标不是让 CC 一口气完成大需求,而是验证三件事:
- 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. 下次接入前要补什么条件。
验收结果
- 当前项目风险边界清楚。
- Git 状态没有被误覆盖。
- 密钥和生产配置没有暴露。
- 第一个真实项目任务足够小。
- 已经知道修改后怎么验收和回滚。