第 05 模块 · 1 节

端到端工程工作流搭建

《Claude Code 进阶实战》05 综合实战 · 本节时长 44 分钟

把进阶能力串成一个真实工作流

前四块(子 Agent、计划模式、技能系统、权限安全)单看都不难,真正的难点是把它们组合成一个可用的工作流。这一节用一个完整任务把它们串起来。

而你要串的,就是贯穿全课的 codex-review——把前面所有能力收束成「一个端到端能跑通的评审工作流」。之前你分块学会了拆解、并行、规划、技能、权限,这一节把它们组合成 codex-review 的完整闭环。

贯穿项目这一节端到端搭建 codex-review:用「计划模式」规划评审流程,用「技能系统」固化评审规则,用「子 Agent」并行拆解评审任务,用「权限模型」限制评审边界,最后整体验证、跑通一份评审报告。四个能力第一次真正合体。

codex-review 要长什么样

动手前,先把「端到端工作流」的目标定下来。一个能跑通的 codex-review,应该长这样:

输入:一次代码改动(分支 / PR / 一批文件)
   ↓
第1步:出评审计划(审哪些、派几路、怎么验收)      ← 计划模式
第2步:确认计划
   ↓
第3步:派三路子 Agent 并行评审                     ← 子 Agent
第4步:三档输出 + 冲突对账                        ← 技能系统约定
第5步:权限边界全程约束(只读、危险必确认)          ← 权限模型
   ↓
输出:一份可照着修的评审报告

目标清晰,再往下搭。


准备:先把评审技能和权限边界就位

codex-review 的骨架是「技能」+「权限」。动手前先确保这两样在:

  1. 评审技能(模块 03 已写):.claude/skills/codex-review/SKILL.md,包含三路并行、三档输出、冲突对账的约定。
  2. 权限边界(模块 04 已写):SKILL.md 里的「权限边界」一节,默认只读、不直接改代码。
任务:端到端跑通 codex-review
已就位:
- 技能:.claude/skills/codex-review/SKILL.md
- 权限:默认只读 + 危险操作必确认
- 缺:一份真实待评审的改动

第 1 步:用「计划模式」规划评审流程

先别开审,用计划模式规划这次评审:

先别开审。给「评审 src/ 这次 30 个文件改动」出个评审计划:
准备派几路(逻辑/安全/风格)?每路审哪些文件、重点查什么?
结论怎么汇总、按什么验收?列出计划,等我确认再开审。

它给出的计划应当覆盖:目标(审出三档清单)、步骤(派三路)、范围(审 src/、不审什么)、风险与回滚(审漏了怎么补)。

你审这份计划:范围对不对?「不审什么」写清了吗?三问(能做吗 / 会碰错吗 / 有退路吗)通过后确认。

可以,按这个评审计划开审。

第 2 步:用「技能系统」固化评审规则

评审规则已经在 SKILL.md 里固化,所以这一步你只需要触发技能,而不是再手打一遍:

用 codex-review 技能,评审 src/ 本次改动。

技能会按约定自动执行:派三路 → 三档输出 → 冲突对账。这就是技能系统的意义——你不用每次重写评审规则,一句触发即到位。

如果你觉得评审规则有遗漏(比如想加一条检查点),现在改 SKILL.md 再触发,而不是在本次对话里临时补。规则沉淀进技能,下次才复用。


第 3 步:用「子 Agent」并行拆解评审

技能触发后,主会话按约定派三个子 Agent 并行评审。你应该看到:

并行三路:
- 逻辑子 Agent:业务正确性、边界情况、异常处理、数据一致性
- 安全子 Agent:注入、越权、硬编码密钥、敏感信息
- 风格子 Agent:命名、格式、重复代码、可读性
各自输出三档清单 → 汇总

三路各自独立上下文、同时推进,总时间 ≈ 最慢那路。这就是「多 Agent 协作评审工作台」的核心。


第 4 步:全程用「权限模型」约束边界

并行评审全程,权限边界要持续生效:

  • 只读不写:三路子 Agent 只读代码、只出结论,不直接改文件
  • 跑命令需单独授权:若需要跑 npm test 验证某个问题,只放行那一条命令
  • 危险操作必确认:任何删除、覆盖、高风险命令,必须停下问你
发现子 Agent 想直接改文件修「必须改」?→ 叫停。
本次是评审,只出报告。要修另开修正任务并单独授权。

权限边界(已写进技能)让三路并行评审既快又稳,不出安全圈。


第 5 步:整体验证

并行结果汇总后,做一次整体验证,对照验收标准:

  1. 三路结论都齐了吗?每路都按三档输出了吗?
  2. 「冲突对账」一节做了吗?被多路提到的位置,结论是否矛盾?
  3. 「必须改」每条都有「位置 + 问题 + 建议」吗?
  4. 权限边界全程遵守了吗(只读、没乱跑命令)?

全部通过,这份 codex-review 评审才算跑通。


一张图回顾这套工作流

计划模式(先规划评审流程)
   → 技能系统(固化评审规则,一句触发)
   → 子 Agent(并行拆解三路评审)
   → 权限模型(兜底:只读、危险必确认)
   → 整体验证(三档 + 对账 + 验收)

四个能力各司其职、缺一不可,组合成了 codex-review 的端到端闭环。


落地练习

练习① 三步走:第 1 步,确认项目里有 codex-review 技能(.claude/skills/codex-review/SKILL.md)和权限边界;第 2 步,挑一个真实分支,完整走一遍五步(出计划 → 确认 → 触发技能 → 三路并行 → 权限约束 → 整体验证);第 3 步,拿到一份「三档齐全 + 冲突对账完整」的评审报告。

② 怎么判断做对了:全程你只需要「出计划 + 确认 + 触发技能」三个动作,其余由技能自动完成;报告里有完整三路结论、冲突对账、每条的「位置+问题+建议」;评审过程只读不写。

③ 卡住了怎么办:如果技能没自动并行,检查 SKILL.md 的「派三个独立子 Agent」写没写清;如果某路结论薄,回技能补充检查点再触发;如果它想改文件,提醒「本次只读」并收紧权限。

常见坑:把「触发技能」当成「这次对话里手打一遍」

端到端最容易翻车的,是技能建好了却不触发,反而在对话里重新手打整套评审指令。有人觉得「这次临时手打也一样」,结果评审规则又回到「每次自由发挥」,技能形同虚设——多 Agent 协作工作台又退回了单次对话。

正确做法:一旦技能就位,就坚持用它触发用 codex-review 技能评审…),把评审规则的制定权交给技能。真觉得规则不对,去改 SKILL.md,而不是在对话里临时覆盖。这样 codex-review 才真正「一次定义、处处复用」。

做法codex-review 跑通的标准是「技能就位后,你能靠一句触发 + 简单确认完成整场评审」。评审规则要改就改 SKILL.md,别在对话里重写。否则技能白建,工作流也不成立。

小结

  1. 动手前先定权限边界
  2. 计划先行、标准沉淀(技能)、并行提速(子Agent)、安全兜底(权限)
  3. 收尾做整体验证(三档 + 对账 + 验收)
  4. 四个能力合体,端到端跑通 codex-review

下一节,复盘这套流程,并学会持续优化——让 codex-review 越用越稳。