用途:仅在用户主动请求独立评审时,对已保存且已批准的设计文档(技术规格、设计文档、RFC、详细 PRD)执行一次外部同行评审,并生成评审发现供用户选择性地采纳。
主要能力:从请求或当前上下文中解析目标规格,必要时才追问;接受额外上下文与输出目录;使用已配置的评审运行时/模型与推理设置,显式覆盖优先,不固定历史模型,也不静默替换用户选定的模型;每轮保留一份发现产物,路径为 <out>/peer-review-findings-roundN.md,并保留此前各轮。
使用方式:读取规格及其关联的契约索引,纳入相关需求、具体示例、测试契约、ADR 决策与受影响表面的说明;仅在依赖或矛盾需要时扩展其他上下文。使用 references/quality-markers.md 中适用的标记,缺失契约记为发现而非在请求评审前自动中止。读取 references/peer-review-prompt.md 并填充占位符(发现路径、轮次、解析后的运行时/模型、上下文路径),评审者只能写该发现文件。通过可用的独立评审运行时(已配置的原生评审者、Compozy 会话或 herdr TUI)启动,使用该运行时文档化的命令,不假定已废弃的 compozy exec API;后续轮次尽量保留既有 worker 身份。检查发现、引用证据与变更路径,并用 bash <skill-dir>/scripts/validate-findings.sh --kind techspec --round <N> --path <out>/peer-review-findings-roundN.md 校验产物。报告结论、实质性发现、限制与产物路径;缺失或格式错误的输出视为评审未完成,绝不判为 READY。
适用场景:需要一次独立外部评审并选择性采纳意见的设计评审流程。
限制:只应用用户选定的发现并记录处置与变更路径;复用已给出的授权,仅对仍缺失的选择追问。明确请求下一轮时,发送变更文件、此前发现/处置与新输出路径,而非再次发送未变更的语料。该技能不授权提交、发布或批准设计;真实的产品/安全/兼容性约束可阻止就绪,缺失的仪式性章节与风格偏好则不能。默认输出目录为 .compozy/tasks/<slug>/ 下的 qa/,否则为 .peer-reviews/<UTC-timestamp>/。