staged-review-flow

分阶段评审流程

内部共享技能。引用此流程的工作流应保留阶段编号、产物存放位置和有意的差异；此技能是评审及验证报告流程的唯一事实来源。

前置条件检查： 加载此技能时，验证每项声明的依赖项是否可用。若缺少依赖项，则停止并打印 npx skills add FuDesign2008/open-skills -g --skill '*' --yes；不得悄悄缩减评审范围。

占位符约定

占位符	含义	引用它的工作流提供
{next-stage}	评审通过后进入的阶段	编号和名称
{artifact-sink}	评审记录或设计摘要的持久化位置	特定宿主的路径或产物
{extra-dimensions}	仅限特定宿主的附加维度	必需检查及其存放位置
{batch-overcap-behavior}	批处理场景中达到自动三轮上限后的操作	特定宿主的处理方式，或 N/A

不得硬编码宿主工作流的阶段编号、OpenSpec 路径、Jira 状态转换或批处理策略。

评审约定

1. 始终加载并运行完整的 solution-review 框架：根据可逆性确定评审深度，涵盖所有核心维度和战略维度。对于影响代码的解决方案，无论其可逆性分类如何，具有长期成本影响的战略维度（成本与价值、团队认知契合度）至少应采用标准深度。
2. 当解决方案影响代码时——包括编写或修改源文件、脚本和生成的配置代码——还应根据适用规则加载并运行 code-design-review 的 Layer A/B/C。
3. 在共享评审之后应用 {extra-dimensions}。这些检查是对 solution-review 的补充，不得替代它。
4. 在报告中将两个轴分开（标签可以不同，但含义必须一致）：
   • 标准——设计／质量／异味／安全适用性（适用时包括 solution-review 的战略与核心质量方面，以及 code-design-review）。
   • 规格——与选定解决方案、工单或 OpenSpec 差异／既定需求的契合度。 两个轴可以并行评审（例如由不同的子 Agent 负责）。不得将两者合并成一份不加区分的排序列表；一个轴通过不得掩盖另一个轴未通过的结果。
5. 将阻塞条件汇总为二元总体结果：
   • 通过： 两个轴及 {extra-dimensions} 均无遗留阻塞问题。
   • 未通过： 任一轴或 {extra-dimensions} 中仍有至少一个阻塞问题。
6. 将评审记录和通过评审的设计摘要写入 {artifact-sink}。

评审循环与关卡

• 在自动模式下，若评审未通过，则优化解决方案、记录优化内容并重新运行完整评审。初始评审加上最多两轮优化后的复评，总计上限为三轮。
• 达到上限时，暂停并等待用户处理，除非 {batch-overcap-behavior} 指定了宿主的批处理方式。
• 在手动模式下，呈现评审报告并等待用户批准、修改或重新选择解决方案。未经用户明确决定，不得进入下一阶段。
• 评审通过后进入 {next-stage}。未通过时，继续优化解决方案，或按用户指示返回解决方案选择阶段。

设计摘要

评审通过后，生成一份结构化设计摘要，包含目标、非目标、决策、风险及缓解措施，以及待解决问题。该摘要属于评审输出的一部分，无需另存为独立文件，除非 {artifact-sink} 要求持久化。

验证报告的真实性

每项验证结果都必须说明其执行状态：

• **已执行：**注明命令或操作，并简要概述输出／结果。
• **待处理：**明确说明仍需执行的手动操作。

不要将设计的场景或推断出的正确性报告为已完成的验证。浏览器或其他无法执行的手动交互仍须标记为待处理，并提供可操作的说明。

使用 completion-evidence-discipline 进行编写：只有当通过该技能的铁律，以当前轮次的新证据作为依据时，才可声称已执行／通过。验证时加载 completion-evidence-discipline；不要将其中的文字粘贴到宿主中。

集成指南

引用工作流必须：

1. 在 frontmatter 依赖项中声明 staged-review-flow，并执行常规依赖项检查门槛（该流程会传递依赖 completion-evidence-discipline）。
2. 在审查阶段加载此技能，并在适用时使用数字和名称映射所有占位符。
3. 仅保留宿主编排内容：阶段退出说明、{extra-dimensions}、{artifact-sink} 和 {batch-overcap-behavior}。
4. 在不超过一两句话内，要求其验证阶段遵守本技能的真实性规则以及 completion-evidence-discipline。

不要在宿主中重复二元表格、阻塞项列表、三轮循环说明、设计摘要模板、双轴定义或验证真实性内容。