03 第3周D16 ClaudeCode工作流
D16 Claude Code 工作流
D16 Claude Code 工作流
精讲(AI 原生培训的核心)。教四个应届生"用 AI 正经干活"的正确姿势。本模块后,第 4 周团队项目全程用它开发。
教学目标(学完能做什么)
- 会安装、配置 Claude Code,理解权限模式
- 掌握对话式开发工作流:描述 → plan mode → 实现 → 测试 → 审查 → 提交
- 会用子代理(Subagent)拆分任务
- 深刻理解 AI 方法论:生成 → 看懂 → 验证 → 提交,绝不盲信
前置要求
- D6(Git,提交要会)、D9(已走过一次 Claude Code 初体验)
本模块在业务中的位置
- 公司全员用 Claude Code 干活(本仓库 CLAUDE.md 就是明证)。新人会用 AI 的效率 = 老员工能带他做的深度。但用错(盲信/不验证)比不用更危险,所以本模块把"方法论"当主角。
内容分段
1. 安装与配置
# 安装
npm install -g @anthropic-ai/claude-code
# 进入项目目录使用;它遵守项目里的 CLAUDE.md/AGENTS.md
cd ~/你的项目
claude- 首次使用按提示登录/授权。
- 权限模式:理解"允许/拒绝/询问"三类操作;公司规范(AGENTS.md 操作分级)同样适用于 AI——Class A 操作 AI 也不许擅自执行。
2. 对话式开发工作流(本次核心)
1. 描述需求(中文,说清目标/约束/验收)
2. plan mode:让 AI 先出方案,确认后再动手
3. 实现:AI 写代码
4. 测试:让 AI 跑测试/自己运行验证
5. 审查:逐段读 AI 改的代码,看不懂就问
6. 提交:中文提交信息,只提交相关文件- plan mode 是保险丝:先要方案再动手,避免 AI 一通乱改。
- 审查不是走过场:AI 可能改坏你没注意的地方,diff 必须逐段看。
3. 子代理(Subagent)
- 用法:大任务拆成独立小任务,各交给子代理并行处理(如"审查这个文件的安全性""搜索这段逻辑在哪")。
- 公司场景:review 代码、跑验证、搜索代码库——都能让子代理干,但结论要自己复核。
4. AI 方法论:生成 → 看懂 → 验证 → 提交(本培训铁律)
| 阶段 | 要求 |
|---|---|
| 生成 | 需求说清楚,中文,给验收标准 |
| 看懂 | 每一段代码都读懂,让 AI 解释你不懂的地方 |
| 验证 | 自己运行、写测试、看结果,跑通才算数 |
| 提交 | 只提交相关文件,中文提交信息 |
- 反例(必须讲给学员听):AI 生成→直接 commit→没跑过→上线炸了。AI 写的不等于对的。
- 什么时候可以信任 AI:当你能解释它为什么这样写、且你验证过行为正确。
5. 与公司规范结合
- 中文交互、中文提交信息(CLAUDE.md 要求)。
- Class A/B 分级同样约束 AI:改配置/发版让 AI 帮忙可以,执行前仍走公司审批。
- 新人 AI 协作红线:不让 AI 碰生产集群、不把 key 交给 AI 打印/提交、不让 AI 覆盖你没看懂的改动。
6. 团队项目前的热身
- 第 4 周项目(D17-D21)里,每人用 Claude Code 开发自己的模块。
- 今天先练:用 Claude Code 重构 D9-D11 的旧作业(改结构/加类型/写测试),体会"看懂并验证"。
讲解节奏建议(约 90 分钟)
| 时段 | 内容 |
|---|---|
| 09:00-09:10 | 引入:AI 是生产力,但盲信是事故 |
| 09:10-09:35 | 安装配置 + 权限模式 + 公司规范对 AI 同样生效 |
| 09:35-10:10 | 6 步工作流(讲师现场完整演示一次) |
| 10:10-10:30 | plan mode 与子代理 |
| 10:30-11:00 | AI 方法论四阶段(正反例都讲) |
| 11:00-11:30 | 学员实操:重构 D9 作业(对应作业) |
| 11:30-11:50 | 常见误区 + 小结 |
| 11:50-12:00 | 布置作业 |
常见误区汇总
| 误区 | 正确理解 |
|---|---|
| AI 生成的直接 commit | 必须 看懂→验证→再提交;跑通才算数 |
| 让 AI 乱改不设 plan | 先 plan mode 要方案,确认再动手 |
| 审查跳过不看 diff | diff 必须逐段看,AI 可能改坏你没注意的地方 |
| 把 key/敏感信息喂给 AI 聊天 | 敏感信息不进对话、不进日志、不提交 |
| AI 说"已测试"就信 | 自己跑一遍验证,结果为准 |
| 全丢给子代理自己不管 | 子代理结论要自己复核 |