用途:该技能用于创建和校验解决方案设计文档(SDD),聚焦解决方案“如何构建”,即技术架构与设计决策,而非代码实现。适用于从模板新建 SDD、补全已有 solution-design.md、校验 SDD 完整性与一致性、设计架构并记录技术决策,以及处理 docs/specs/ 下的任何 solution-design.md 文件。
主要能力:按 template.md 的固定结构撰写文档,覆盖架构与模式、代码位置(目录结构与组件)、接口(API、数据模型、集成)、决策理由(ADR)。写作时对齐 PRD 需求、既有代码模式与 PRD 约束。每节通过“发现—文档—评审”循环推进:阅读 PRD、探索代码库,并并行启动架构、数据模型、API、安全、性能、集成等专项代理调研;更新 SDD 并替换 [NEEDS CLARIFICATION] 标记;向用户完整呈现调研结果、冲突建议与权衡,等待确认后再进入下一轮。
校验:完成前执行重叠与冲突检测、覆盖分析、边界验证、一致性核验,参照 validation.md 检查表,重点包括:所有必需章节完成、无待澄清标记、上下文来源及相关性已列出、项目命令来自真实项目文件、约束→策略→设计→实现路径合乎逻辑、架构模式及理由明确、图中每个组件有目录映射、每个接口有规格、错误处理覆盖全部错误类型、质量要求可度量且有测试覆盖、所有架构决策经用户确认、组件命名一致、开发者可据此实现。
用法:模板位于 plugins/start/skills/solution-design/template.md,需写入 docs/specs/[NNN]-[name]/solution-design.md。
限制:仅做研究、设计与文档,实现属于另一阶段;决策需用户确认;资料未提供工具安装方式、运行环境、付费与平台信息。