


























你熟悉了 Coach、Workflow、Inspector 这些核心技能。但有一天你遇到了一个老项目迁移——没有文档、没有测试、没有蓝图。你发现 Coach 和 Workflow 都不太对——它们是为"从零开发"设计的,不是为"迁移老项目"设计的。这时候你需要的是 Legacy Recon。
14 个技能中,最容易被混淆的是 Coach、Workflow、Orchestrator、Job 这四个。它们都做"开发",但自动化的程度不同。理解它们的区别,是正确使用技能体系的关键。
Coach 是最基础的。 它引导你走完六步流程,但每一步都需要你亲自确认——拆解方案需要你同意、验收结果需要你判断、分支决策需要你拍板。它像一位耐心的教练,在你旁边说"先做这个,再做那个,现在检查一下"。它的价值在于"流程引导",不在于"效率提升"。当你还不熟悉 AI 编码的流程时,Coach 是最好的入门选择。
Workflow 是 Coach 的自动化版本。 它把"需要用户判断"的步骤,变成了"用规则判断"。验收标准是明确的,所以分支决策可以自动化。下发指令是模板化的,所以不用每次都手写。Workflow 把"六步流程"变成了"一个指令"——你说"完整实现这个功能",它自动走完所有步骤。当你的需求明确、技术方案已定时,Workflow 比 Coach 高效得多。
Orchestrator 管理多个 Workflow。 当你需要同时做多个功能时,Orchestrator 在 Workflow 之上加了一层管理——它负责安排功能的开发顺序、管理依赖关系、确保跨功能的集成正确。
Job 站在最高层。 它不只是"做功能",而是"做整个项目"——从脚手架搭建到部署配置生成,7 个环节全部自动化。Job 会依次调用 Requirements、Architect、Frontend Architect、Orchestrator、Inspector。
选择哪一个,取决于你的需求层次:
这个选择逻辑可以画成一条"从新手到专家"的路径:新手用 Coach → 熟悉后用 Workflow → 多项目用 Orchestrator → 重复项目用 Job。每个阶段对应不同的自动化程度,你可以随着经验的增长逐步升级。
除了四个核心流程技能,还有五个技能解决"不是从零开始"的特殊场景。知道什么时候用它们,和知道什么时候用核心技能同样重要。
代码克隆(Cloner)——当你需要参考现有代码实现新功能时。场景:你有一个功能,和项目中另一个功能的实现模式完全一样,只是业务逻辑不同。用 Cloner 可以"按这个模式实现那个功能",而不是从零写。它的核心方法是分析现有代码的模式,按照同样的风格和结构实现新功能。
老系统还原(Legacy Recon)——当你需要从老系统迁移到新系统时。场景:接手一个没有文档、没有测试、没有蓝图的遗留项目。Legacy Recon 先扫描代码、还原架构、提炼蓝图,然后再开始改造。它的进阶用法是"字段级对照"——逐字段对比老系统和新系统的实现,确保没有遗漏。
项目接续(Next)——当你接手一个半成品项目时。场景:别人做了一半的项目交给你。Next 先分析当前状态、识别未完成的工作、建立上下文。它的进阶用法是先评估项目的"代码体量"——源文件数、代码行数、测试覆盖率——然后决定是继续开发还是重建。
高保真原型(POC)——当你不确定一个方案是否可行时。场景:你想先确认前端效果再正式开发。POC 生成纯前端的高保真页面,使用模拟数据,不需要后端介入。POC 还可以作为"需求确认工具"——让业务方看到真实界面后再确认需求,减少需求变更。
质量保障(QA)——当项目需要全面测试时。场景:项目完成后,需要系统性的测试覆盖。QA 不是"写测试",而是"设计测试策略+生成测试用例+执行测试+报告结果"。
总结一下触发逻辑:
以下技能的进阶用法和最佳实践,供按需查阅。
设计原理: 需求分析技能的底层方法是 Event Storming——一种通过"事件"来理解业务的技术。它不先讨论"系统有什么功能",而是讨论"业务中发生了什么事件"。
这种方法的好处是:业务人员不需要懂技术也能参与讨论。 他们只需要描述"发生了什么",技术人员从事件中推导出数据模型和系统结构。
进阶用法:
用法一:分歧驱动。 不是所有需求都能一次性对齐。当需求分析中出现分歧时,不要试图立即解决,而是记录分歧。分歧本身暴露了需求中的模糊点,这些模糊点如果不解决,会在后续开发中导致返工。
用法二:场景枚举。 对于复杂功能,枚举所有可能的场景比抽象描述更有效。比如订单取消功能,列出"下单后立即取消""支付后取消""已发货后取消""已收货后取消"四个场景,比一句"支持取消订单"清晰得多。
最佳实践: 需求分析的产出不仅是功能列表,更重要的是分歧记录和场景枚举。让 AI 扮演"挑剔的提问者",不断追问边缘情况。不要追求"一次性对齐",接受"逐步收敛"。
设计原理: 架构设计的核心思想是"无蓝图不开工"。但蓝图不是一成不变的,它需要随着项目的推进而更新。
进阶用法:
用法一:双向推演。 对于已有代码的项目,先做自下而上的分析——扫描文件、识别模式、抽象结构——再自上而下地调整和优化。
用法二:ADR 驱动。 重大架构决策记录在 ADR 中。ADR 的价值不是"记录决策",而是"记录决策的原因和上下文"。一个好的 ADR 能让未来的开发者理解:为什么在 A 和 B 之间选择了 A,当时考虑了哪些因素,放弃了什么。
最佳实践: 术语表优先于数据模型——在讨论表结构之前,先对齐术语。骨架先行——先产出完整的骨架,再填充细节。每个设计决策都要有"为什么"——不让 AI 默认选择,而是让它解释选择的原因。
设计原理: Coach 是"引导式"的——它不替用户做决策,而是引导用户自己做决策。它的核心价值是培养习惯,而不是完成任务。
用法一:习惯养成
Coach 的主要作用不是"帮你完成这个功能",而是"帮你养成正确的编码习惯"。
用法二:渐进式放手
随着用户对流程的熟悉,Coach 可以逐步减少引导:
Workflow 的核心是"三步迭代循环":下发指令 → 验收 → 分支判断。它把六步工作法中的"拆解"和"更新图纸"留给更上层的技能(Orchestrator 或 Job),专注于执行层的自动化。
用法一:上下文重置策略
Workflow 在长流程中需要管理上下文重置。关键策略是:
为什么需要重置? AI 的对话上下文是有限的。当对话超过 100 轮后,AI 的表现会显著下降。重置上下文相当于让 AI "休息一下,重新集中注意力"。
用法二:验收标准的演进
验收标准不是一成不变的。随着项目的推进,验收标准应该越来越严格:
Inspector 的核心是"对比"——对比 AI 生成的代码和蓝图,找出差异。它不评价代码"好不好",只评价代码"是否符合蓝图"。
用法一:架构偏移的三维检测
Inspector 从三个维度检测架构偏移:
用法二:安全审查的自动化
Inspector 可以集成安全审查规则:
Orchestrator 的设计思想是"分而治之"——把大项目拆成小功能,每个功能独立完成,再通过集成验收确保整体正确。
用法一:并行执行
当多个功能没有依赖关系时,Orchestrator 可以并行调度它们:
Phase 1: 基础架构(串行,有依赖)
1.1 项目初始化 → 1.2 数据库 → 1.3 用户认证
Phase 2: 核心功能(可并行,无依赖)
2.1 订单列表 ─┐
2.2 创建订单 ─┤ ← 这些功能可以并行执行
2.3 用户管理 ─┘
2.4 商品管理 ─┘
并行执行的核心约束:每个功能在独立的上下文中执行,避免共享状态冲突。
用法二:增量开发
Orchestrator 支持增量开发——项目已经部分完成,只需要添加新功能:
Job 的设计思想是"阶段即子代理"——每个阶段作为一个独立的子任务执行,主会话只做两件事:读取状态文件确定当前阶段,调度子任务执行。
用法一:断点续传
Job 的进度状态写入文件系统,支持断点续传:
job.state.json → 找到当前阶段用法二:自定义阶段
Job 支持在标准流程中插入自定义阶段:
标准流程:Scaffold → Requirements → Architect → Develop → ...
自定义插入:在 Architect 之后插入 Security Review 阶段
什么时候用: 遇到技术决策困难时。
核心方法: 提供选项、分析、推荐,让用户做决策。
进阶用法: 让 Advisor 模拟"魔鬼代言人"——用 AI 反驳自己的推荐,暴露方案的弱点。
什么时候用: 需要参考现有代码实现新功能时。
核心方法: 分析现有代码的模式,按照同样的风格和结构实现新功能。
进阶用法: 一次分析多个现有功能,提取通用的模式模板,然后批量应用。
什么时候用: 在正式开发前,先确认前端效果。
核心方法: 生成纯前端的高保真页面,使用模拟数据,不需要后端。
进阶用法: POC 可以作为"需求确认工具"——让业务方看到真实界面后再确认需求,减少需求变更。
什么时候用: 需要从老系统迁移到新系统。
核心方法: 分析老系统的界面和功能,生成新系统的方案和代码。
进阶用法: 先做"字段级对照"——逐字段对比老系统和新系统的实现,确保没有遗漏。
什么时候用: 接手一个半成品项目。
核心方法: 分析现有代码的结构和状态,找到最适合继续开发的切入点。
进阶用法: 先评估项目的"代码体量"(源文件数、代码行数、测试覆盖率),然后决定是继续开发还是重建。
14 个技能中,Coach、Workflow、Orchestrator、Job 构成了从手动到全自动的自动化阶梯——选择哪一个取决于你的需求层次和自动化需求。特殊场景技能(Cloner、Legacy Recon、Next、POC、QA)覆盖了"不是从零开始"的场景,知道什么时候用它们和知道什么时候用核心技能同样重要。其他技能的进阶用法和最佳实践可以作为参考手册按需查阅。下一章,我们将通过一个完整的项目案例,回顾所有技能的实际协作。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。