dev-design-gate

name	dev-design-gate
version	2.3.2.3
description	个人开发者轻量设计门禁。对 dev-design.md 做 7 项质量检查，判断其是否足以进入任务拆分（task-split），输出 通过/不通过/阻塞 结论与整改清单。报告落盘 .sdd/{SR}/.context/dev-design-gate.md，只写结论与需整改项，不填充冗余模板。Use when the user asks for 轻量门禁、设计检查、dev-design-gate，或通过 aaw-workflow 的 dev 入口完成设计后进行门禁。

前置操作：工作流编排检查

若本 skill 是由 aaw-workflow 的工作单调用的，跳过本节，直接执行正文。

否则，在执行正文之前，先向用户发起一次二选一确认：

是否回到 aaw-workflow 工作流中执行？

• 是，回到工作流（推荐）——进度会被跟踪和上报
• 否，单独执行本 skill——本次执行将不纳入流程跟踪

• 用户选“是” → 加载 aaw-workflow skill，按其流程执行（其入口意图判定会引导继续已有工作流或新建），不再单独执行本 skill 正文。
• 用户选“否” → 继续执行本 skill 正文，之后不再提及工作流。

本节最多询问一次，不得重复打扰。

若工作单输出已存在，仍按当前要求完整执行：先读取并评估已有成果，复用仍有效的信息和已确认答案，可局部修改或整体重写，并写回原路径。

dev-design-gate

定位

检查 dev-design.md 是否足以进入 task-split。门禁关注的是设计是否给出了足够确定、可执行、可验证的指导，而不是挑文采或凑章节。

它接管了 SR 入口中 sr-design-gate / module-design-gate 的准入职责，但适配单份扁平文档，检查项收敛为 7 项，报告从 120-250 行模板压缩为结论 + 整改项。

门禁阶段只读 dev-design.md 和相关输入，不修改设计正文。整改由上游 dev-design 阶段完成。

唯一成果物

.sdd/{SR}/.context/dev-design-gate.md

报告按 references/gate-report.md 骨架生成，只写本轮结论与需整改项。重复运行时覆盖更新该文件，保留已清零项的痕迹（如有）。

7 项准入检查

每项给出 达标 / 未达标 / 不适用 判定，未达标项必须指明问题出处与整改方向。

#	检查项	关注点	不达标影响
1	现状证据充分性	代码取证已完成：## 8. 现状附录 存在、覆盖本次需求映射到的代码位置/函数/调用链/测试；附录关键结论带 file:line 引用可回溯；## 2. 现状摘要 与附录一致、无矛盾；软件架构缺失时已记录"无架构基线"	设计脱离现状凭空推导，task-dev 踩已有约束
2	范围确定性	需求目标与边界写清，明确不做什么；范围外的需求不被悄悄纳入	拆分出的任务边界模糊
3	方案确定性	给出了明确方案选择，不存在未决的"可选/待定/看情况"	task-dev 无从下手或自行发挥
4	契约完整性	新增/修改的接口、数据结构、配置、错误码、CLI 参数有名称、位置、签名/字段、类型、调用方、错误语义	直接带病进入编码
5	可执行性	改动有明确工程落点，影响文件路径经代码确认而非猜测；无法从设计定位实现位置	task-dev 边做边猜
6	验收闭环	每条验收标准可执行可判定，覆盖需求全部目标；无"无法验证"的遗漏	无法判断完成与否
7	存疑清零	影响实现或验证的存疑项已解决或明确由用户拍板	任务计划带 Open Questions

现状证据充分性是第一准入项：dev-design 把 SubAgent 委托的代码取证作为固定环节，门禁应确认取证已发生且落进文档。现状附录缺失、关键结论无可回溯引用、摘要与附录矛盾、或取证未覆盖需求涉及的代码位置时，判未达标，回 dev-design 补取证。

核心验收不得待处理：某条验收若"当前无法验证"且没有归属，直接判未达标；只有补充性、非阻塞验证才可标注为后续待办。

结论判定

中文结论	gate_result	判定条件
通过	pass	7 项全达标或全部"不适用"，不存在影响实现的存疑
不通过	fail	存在可通过修改 dev-design.md 解决的未达标项，或破坏了现状证据/范围/契约/验收闭环
阻塞	blocked	缺少必要输入（如 requirement.md 与 dev-design.md 都缺失不可读），或必须由用户提供事实/作出决策才能继续判断

任一适应检查项未达标或存在影响实现的存疑，不得通过。

具体流程

1. 完整读取 dev-design.md；存在 requirement.md 时对照核验范围是否被曲解或遗漏。
2. 按 7 项逐一判定，未达标项定位到具体章节或行，给出整改方向。
3. 第 1 项「现状证据充分性」优先判定：先确认取证与现状附录情况，再判定其余设计项。
4. 汇总未达标项与需整改项，生成结论。
5. 按 references/gate-report.md 骨架写报告到 .context/dev-design-gate.md。
6. 按 data_schema 构造 gate_result / recommendation / report / summary 提交给 CLI：
   • pass 时 unqualified_items / blocking_issues / pending_questions 必须为 0；
   • fail / blocked 时如实填写未达标项与阻塞项数量。

报告边界

报告必须包含

• 本轮结论（通过/不通过/阻塞）与一句话理由；
• 未达标项列表（每项：检查项编号、问题描述、整改方向）；
• 存疑或阻塞项列表。

报告不要包含

• 设计文档的复述或摘要；
• 与 7 项准入无关的常规性建议；
• 模板中本轮用不上的空章节。

自检清单

• 已完整读取 dev-design.md（及存在时的 requirement.md）。
• 7 项检查逐项判定，不存在跳过未判的适用项。
• 已优先确认「现状证据充分性」：附录存在、摘要与附录一致、取证覆盖需求相关代码位置。
• 报告已写入 .context/dev-design-gate.md，只含结论与需整改项。
• 结论与 summary 数字一致；pass 时三项均为 0。
• 未修改 dev-design.md 正文。