用途:为 AI 开发工作流(ADW)设计 Plan/Build/Review/Fix 四个可组合步骤原语,适用于创建新步骤、定义输入输出契约、实现步骤隔离、设计组合策略、构建 ADW 工作流变体。
四个步骤类型:/plan 产出确定性结果(spec 文件,路径已知、内容结构化);/build 为非确定性(代码变更,创造性、自适应);/review 产出确定性结果(PASS/FAIL 报告,结构化可解析);/fix 为非确定性(针对性修复、聚焦纠正)。
设计流程:1)定义契约,每个步骤用输入(如 task_description、project_path)和输出(如 spec_file_path、success)明确 I/O;2)确保隔离,步骤需通过参数或文件路径接收输入、输出到已知位置、不依赖其他步骤先运行、干净完成或失败、可独立测试;3)定义成功标准,如 Plan 需生成 spec 且含验收标准与明确技术方案,Build 需覆盖需求并编译通过、测试通过、提交变更;4)设计错误处理,如 Plan 无法生成 spec 则补充上下文重试,Build 报错则回到 plan,Review 发现严重问题则进入 fix,Fix 无法修复则升级给人工;5)定义组合规则,如 Plan → Build、Plan → Build → Review、Plan → Build → Review →(FAIL 时)→ Fix 循环直至 PASS 或达上限。
提供各步骤的斜杠命令模板与循环上限模式(如 MAX_FIX_ATTEMPTS = 3,超过后升级人工)。前置要求:理解 @composable-steps.md、熟悉 @adw-framework.md 模式、了解确定性与非确定性执行。注意:完整步骤编排需要 Claude Agent SDK,本技能提供步骤设计模式与契约。需避免的常见反模式包括步骤耦合、无界循环、契约未定义、缺少成功标准、无错误处理。版本 v1.0.0(2026-01-01)。