菜单
基于已共识 PRD 与 ASD/spec-asd 按 §1-§3 分段「澄清 → 生成 → 烤干」直写 DSD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-design、编写/修改 DSD、API、DDL、错误码、幂等、时序、validate-dsd 且可对齐上游 ASD 或 spec-asd 时，使用本技能。 分流：只要 PRD/ASD/TDD/docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
在已共识 SOLUTION 上按六章分段「澄清 → 生成 → 烤干」细化 FR/MVP/依赖/风险， 并直写 ANALYSIS-{IDEA-ID}.md；每段写前意图澄清，写入后自动 grilling 至收敛，用户确认后再推进下一段。 用户提到 /sdx-analysis、拆 MVP、需求分析、细化方案且可对齐上游 SOLUTION 时，使用本技能。 分流：无 SOLUTION、只要其他 SDX 阶段或 docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。
逐步确认参数，按模板分段「澄清 → 生成 → 烤干」直写 SOLUTION-{IDEA-ID}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-solution、写方案、整理业务目标、需求模糊要结构化成共识级解决方案、 写 SOLUTION-*.md / 七章方案、一口气写完整版、选 F 补齐剩余章节时，务必使用本技能（分段协议与 F 门禁；非法整篇覆盖也须加载本技能以拒绝）。 分流：ANALYSIS/PRD/ASD/DSD/TDD 或 docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。
维护或初始化仓库根目录 README.md 与 AGENTS.md。 用户提到 /docs-agent、入口与 INDEX 不同步、口述「写 README」「更新 AGENTS」时，使用本技能。 分流：用户只要 docs-indexing/docs-build/docs-upgrade 或 SDD/distill/extract → 对应技能。 推进见 references/gates.md。
将 overview 知识按表格行内副标题链接归档到 system/company 视角章节； 先收口方案确认书，再按当前单元落目标章并按策略回写 overview。 用户提到 /docs-archive、知识归档、overview 落盘、冲突检查、确认书归档时，使用本技能。 分流：任意源提炼 → docs-extract；应用蒸馏 → docs-distill；实体/KNOWLEDGE_INDEX → docs-build；术语替换 → docs-upgrade；SDD → 对应技能。 推进见 references/gates.md。
从五视角提取实体 ID，产出 per-entity {ID}.md、各视角 README、扫描生成 KNOWLEDGE_INDEX.md；依赖主 Index Guide。 用户提到 /docs-build、初始化/同步知识实体、对齐 ID、docs-indexing 下游要实体时，使用本技能。 分流：仅 INDEX → docs-indexing；overview → distill/extract；归档 → docs-archive；SDD → 对应技能。 推进见 references/gates.md。
从 Git、CHANGELOG*、本地 mtime 三源采集变更，写入 {output_dir}/CHANGE-LOG.md，文末保留增量基线注释。 用户提到 /docs-change、变更聚合、「记录改动」「最近改了什么」时，使用本技能。 分流：INDEX / 实体 / 归档 / 术语为主路径 → docs-indexing、docs-build、docs-archive、docs-upgrade。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。
| name | sdx-design |
| description | 基于已共识 PRD 与 ASD/spec-asd 按 §1-§3 分段「澄清 → 生成 → 烤干」直写 DSD-{IDEA-ID}-{N}.md； 每段写前意图澄清，写入后自动 grilling 至收敛，再由用户确认推进。 用户提到 /sdx-design、编写/修改 DSD、API、DDL、错误码、幂等、时序、validate-dsd 且可对齐上游 ASD 或 spec-asd 时，使用本技能。 分流：只要 PRD/ASD/TDD/docs-* 主路径 → 对应技能，不以本技能代跑。 推进见 references/gates.md。 |
| compatibility | Bash 5+；校验脚本 agent/skills/sdx-design/scripts/validate-dsd.sh（仅结构/内容校验）。 |
API / DDL/TBL / LOGIC / 错误码组 / 幂等·时序·安全块）；一次一段（除非 F 且已批确认意图）。C/M/G/F（无 S）/ 烤干 → intent-clarify.md、unit-cycle-protocol.md、grilling-skill.md、docs-simplify.md；细节 gates.md。PRD 与 ASD/spec-asd；缺 PRD → sdx-prd；缺 ASD/spec-asd → sdx-architect 或按缺口标注受限继续。不写 ASD，不产 TDD。scripts/validate-dsd.sh（见「产出与校验」）。| 负责 | 不负责 |
|---|---|
DSD-{IDEA-ID}-{N}.md 实现级详设、参数向导、意图澄清、分段生成、段内烤干、§1-§3 与 §2 API/DDL/LOGIC/错误码/幂等/时序 | PRD/ASD/TDD/SOLUTION/ANALYSIS 初稿；docs-* 主路径；实现代码与自动化测试 |
DSD 偷换成 ASD/PRD/TDD 或 docs-* 主路径| 目的 | 文件 |
|---|---|
| 流程 / 推进 binding | workflow.md、gates.md |
| 原则 / 反模式 | design-principles.md、anti-patterns.md |
| 易错 / 受众 / 终检 | gotchas.md、audience-and-language.md、quality-checklist.md |
| KNOWLEDGE_TYPE | knowledge-type-modes.md |
| 模板 | dsd-template.md、上游 asd-spec-template.md |
PRD-{IDEA-ID}-{N}.mdASD-{IDEA-ID}-{N}.md 和/或 spec-asd-{IDEA-ID}-{N}-{app-name}.md{DOC_DIR}/requirements/REQUIREMENT-{IDEA-ID}/MVP-Phase-{N}/ 可写IDEA-ID、N、章节范围、深度、上游文档范围，则直接进入参数向导确认{DOC_DIR}/requirements/REQUIREMENT-{IDEA-ID}/MVP-Phase-{N}/DSD-{IDEA-ID}-{N}.mdagent/skills/sdx-design/scripts/validate-dsd.sh
agent/skills/sdx-design/scripts/validate-dsd.sh --file path/to/DSD-xxx.md
evals/evals.json、grader.md。聚焦：意图澄清、当前段推进、上游 PRD/ASD、边界分流。