用途:协调对已有设计文档的独立评审与聚焦修订,避免把评审历史变成实现规格。该技能负责将文档正常推进为 Revised,不同步 issue,也不实现用户故事。
主要能力与流程:先读取 ../design-doc/references/design-contract.md、目标设计与仓库说明;选择设计文档,若发现多个可能文档则请用户选择。评审期间文档保持 Draft,即使进入循环时已是 Revised。每轮使用全新的评审子代理,遵循 design-doc-reviewer,评审者只读;由协调者或单独写作者应用修订,避免评审者批准自己的工作。若委派需要权限,用户请求使用本循环、重复评审、准备功能交付或启动评审者即视为足够授权,否则先请求权限。
处理结论:校验通过且阻塞性发现为零则继续推进;若阻塞项需要产品决策、扩大范围、删除/推迟故事、选择破坏性迁移或改变明确用户决定,则暂停等待用户;否则依据证据与必需不变量修订。修订要经济:将发现分类为接受、以更小替代方案解决、有证据驳回或需用户输入,不盲目实现评审者示例方案;共享需求变化时更新所有受影响规范故事;设计只加一行变更日志,详细处置留在版本化评审产物或交接中。
后续评审与收敛:由新评审者做聚焦跟进评审,验证先前阻塞项、变更与受影响面、机械校验和关键回归,跨切面变更时才扩大为完整评审。持续有进展则重复,默认上限五轮;非阻塞建议可保留或明确豁免,不触发新一轮。达到上限或同一阻塞项无法在无用户输入下解决时,报告并保持 Draft。
推进与就绪证明:最新独立评审给出 Ready 后,将状态设为 Revised,添加带日期的紧凑变更日志行,并运行:
python3 <story-contract-script> <design-doc>
--repo-root <repository-root> --mode delivery
若 delivery 模式校验失败,恢复 Draft,修复机械问题,并在推进前再获得一次独立聚焦评审。用户明确覆盖可在机械有效时推进,但须说明确切风险并在变更日志保留覆盖记录;机械失败必须修复。不得从普通循环请求推断覆盖权限。
评审者提示词:使用 design-doc-reviewer 技能进行独立的 <initial|follow-up> 评审,提供设计路径与先前评审路径(或 none),保持只读,保存下一版本化评审产物,运行 author 模式 story-contract 校验;跟进评审需验证先前阻塞项、变更与受影响面及关键回归,仅在跨切面变更需要时扩大。返回评审产物、结论(Ready | Not ready)、机械校验(Pass | Fail)、阻塞性发现、非阻塞建议、所需用户决定、受影响故事 ID。
最终报告:报告设计路径、最新版本化评审产物、轮次、author 与 delivery 模式校验结果、最终状态、已豁免的非阻塞建议、剩余用户决定或风险。不要启动 design-to-issues 或 feature-delivery。
限制:资料未提供具体安装命令、收费、价格、平台或效果信息。