SuperAPI AI 工具集

spec-design

设计与创作

查看项目

更新于 10-16 08:46

技能介绍

用途:spec-design 是一个 D2 worker skill,只负责产出可评审的决策文档(Decision Doc/RFC)到 {FEATURE_DIR}/design/design.md。它不做分流决策,是否跳过 design(D0)、是否需要 research(D1)由 using-aidlc 作为唯一路由器判定。

主要能力与门禁:遵循“门禁优先(spec-context)→ 强制消费影响分析与项目知识库 → 决策落盘”的原则。任何读写 {FEATURE_DIR}/design/*.md 之前,必须先执行 spec-context 获取上下文并回显 FEATURE_DIR=...(允许 (reuse)),失败立即停止。D2 必须读取 {FEATURE_DIR}/requirements/solution.md#impact-analysis,并据此全文读取受影响模块组件页与相关 ADR;读不到必须显式标注 CONTEXT GAP,不得静默跳过。

使用方式:需要产出 design/design.md(RFC/Decision Doc)或“做设计再进入 implementation”时使用。使用最小化模板(assets/design-template.md)复制到 {FEATURE_DIR}/design/design.md 再填写,包含 In/Out、C4 L1–L3、备选方案、风险与验证清单、追溯链接等。写决策而非实现:不写实现步骤、任务拆分、字段清单、DDL 细节;对外承诺字段以要点加追溯链接呈现。

限制与约束:需求未完成 R1(缺少 requirements/solution.md)时不适用,应先走 spec-product-clarify;用户只要实现计划则走 implementation。在时间或权威压力下,仍禁止猜路径、禁止缺少 SSOT 时脑补推进、禁止只读索引或摘要就宣称“已对齐”。CONTEXT GAP 不得作为 DoD“对齐已完成”的通过理由。完成后需输出 ROUTER_SUMMARY 并调用 using-aidlc 路由下一步。