用途:这是 agent-toolkit 流水线的第二阶段(Spine phase 2)。在架构审批通过后运行,目标是在进入 plan 和 implement 之前,敲定每一项关键的行为与契约决策,同时为本地、可逆、符合惯例的实现选择保留自由度。未解决的关键决策会在 implement 阶段被退回(kickback)。
主要能力:先做接口清单,从 architecture.md 提取新增或修改的接缝、接口与重构范围;随后进行分批决策确认,每项给出用户拥有的关键问题、推荐方案、理由与备选,要求逐项明确回应(接受、选择备选或给出决策),沉默不算接受。只就公共契约、安全策略、兼容/迁移、固定接缝、不可逆或高成本承诺、有意义的架构或运维权衡提问;本地私有可逆的细节按仓库惯例自动选择。之后执行一次有界的 implement-as-if 评审(SV-* 循环),由新的评审者做只读检查,产出 blocker/major 级发现并一次性修复,再由独立验证者仅复核原 ID。最后写入 decisions.md、与 architecture.md 对齐并请求审批。
使用方式:需先加载 manifest.yaml 校验前置条件(phase 为 specify、approvals.specify 为 pending、architecture.md 存在且校验通过)。脚本位于技能自身 scripts/ 目录,需设置 SKILL_DIR 为技能绝对路径,并从项目根目录运行,例如:node "$SKILL_DIR/scripts/review-log.mjs" record --id <id> --phase specify --cycle specify-N --role auditor --reviewer "<fresh label>" --verdict approved;审批用 node "$SKILL_DIR/scripts/manifest-approval.mjs" --id <id> --approval specify --approve。若 manifest.class = epic,走 Epic Specify 路径,仅处理跨子变更的共享契约,并在审批后自动运行 epic-split.mjs 拆分。
适用场景:需要先固化接口、数据契约、错误处理、并发顺序、配置、迁移兼容、测试场景、可观测性与重构范围等决策的变更;也用于 implement 退回后的修订会话。
限制:具体脚本参数、模板与参考文件细节以技能内文档为准;本资料未提供收费、平台支持范围等信息。