design

/design -- 产品验证关卡

快速参考： 在发现阶段开始大量工作之前，验证拟议目标是否符合产品的战略方向。由 --preset=product 控制委员会评审。

---

快速开始

/design "add caching layer for CLI"           # validate goal against PRODUCT.md
/design --quick "add caching layer"           # inline check, no council spawning
/design --strict "redesign hook system"       # higher threshold (avg >= 2.5)
/design                                       # infers goal from recent context

---

执行步骤

步骤 0：检查 PRODUCT.md

在仓库根目录中查找 PRODUCT.md。

ls PRODUCT.md 2>/dev/null

如果不存在： 输出警告并返回 PASS，同时注明：“未找到 PRODUCT.md —— 跳过产品验证关卡。运行 /product 以生成该文件。”

如果存在： 继续执行步骤 1。

步骤 1：加载产品背景信息

读取 PRODUCT.md 并提取：

• 使命 —— 产品的核心宗旨
• 用户角色 —— 定义的用户类型及其需求
• 差距 —— 已知的产品差距或路线图事项
• 竞争格局 —— 产品的差异化优势

如果缺少任何章节，将其标记为不可用，并保守地为该维度打分（1）。

步骤 2：对齐矩阵评分

根据 references/alignment-matrix.md 中的评分标准，评估拟议目标的以下五个维度。

维度	分数（0-3）	理由
差距契合度		此目标是否解决已知的产品差距？
用户角色契合度		此目标是否服务于已定义的用户角色？
竞争差异化		此目标是否增强竞争地位？
先例		以前是否做过类似工作？我们能从中学到什么？
范围契合度		此目标的范围是否适合当前阶段？

计算五个维度的平均分。

步骤 3：运行委员会评审

使用产品预设调用委员会。评审者配置请参阅 references/product-council-preset.md。

Skill(skill="council", args="--preset=product validate design alignment for: <goal>")

将步骤 2 中的对齐矩阵作为背景信息传递给委员会评审者。

如果设置了 --quick 标志，则跳过启动委员会，改为执行内联评估。

步骤 4：编写设计文档

将设计文档写入 .agents/design/：

mkdir -p .agents/design

文件名：<date>-design-<goal-slug>.md（例如，2026-03-30-design-add-caching-layer.md）

文档内容：

• 目标陈述
• 包含分数和理由的对齐矩阵
• 委员会裁定（如果使用 --quick，则为内联评估）
• 最终裁定和建议

步骤 5：输出裁定

根据分数确定最终裁定：

条件	裁定
平均分 >= 2.0 且没有任何维度为 0	PASS —— 目标符合产品方向
平均分 >= 1.5，或一个维度为 0 且其他维度得分较高	WARN —— 目标存在契合度问题，继续之前请先审核
平均分 < 1.5，或多个维度为 0	FAIL —— 目标不符合产品方向

设置 --strict 时，将 PASS 门槛提高到平均分 >= 2.5。

按以下格式输出裁定：

DESIGN VERDICT: <PASS|WARN|FAIL>
  Gap Alignment:     <score>/3 -- <one-line rationale>
  Persona Fit:       <score>/3 -- <one-line rationale>
  Competitive Diff:  <score>/3 -- <one-line rationale>
  Precedent:         <score>/3 -- <one-line rationale>
  Scope Fit:         <score>/3 -- <one-line rationale>
  Average:           <avg>/3.0
  Artifact:          .agents/design/<filename>.md

---

标志

标志	效果
--quick	不启动委员会，执行内联检查。速度更快，但不够全面。
--strict	将 PASS 门槛从平均分 >= 2.0 提高到平均分 >= 2.5。适用于影响重大的变更。

---

参考文档

• references/design.feature — 可执行规范：在发现阶段之前，评审目标与 PRODUCT.md 的契合度并给出委员会裁定；--quick 使用内联评估；--strict 提高门槛（soc-qk4b）

• references/alignment-matrix.md -- 五个对齐维度的评分标准

• references/project-reality-check.md -- 确定项目方向之前的快速现实检查提示

• references/product-council-preset.md -- 委员会 --preset=product 评审者配置和裁定规则

---

See Also

• skills/council/SKILL.md -- Multi-model consensus council
• skills/product/SKILL.md -- Generate PRODUCT.md
• skills/discovery/SKILL.md -- Discovery phase orchestrator
• skills/pre-mortem/SKILL.md -- Plan validation gate