用途:把已验证的需求文档转化为单一、免实施的设计文档,供下游任务分解使用。
主要能力:读取需求文档并确认范围与约束;提出2-3种架构/组件/数据流方案并记录优缺点与最佳适用;生成含目标、架构、组件、数据流、错误处理策略、测试策略(验证方法而非测试代码)、权衡与验收标准的设计文档;保存并获取用户批准后移交任务分解。
使用方式:输入需求文档路径或内容,可选项目背景、现有设计或ADR。先检查docs/ARTIFACT_NORMS.md的项目约定,默认保存到docs/design-decisions/YYYY-MM-DD-<topic>.md,并带前置内容(artifact_type、created_by、lifecycle、created_at)。澄清时一次一个问题,转交前需用户明确同意。
适用场景:需求已验证、需要实施前详细设计;需要组件边界、数据流与技术权衡;需要可供实施与任务分解依赖的唯一设计文档。
限制:不生成代码、脚手架或实施步骤;需求模糊或缺失时应先做需求分析;不生成任务列表,需移交breakdown-tasks;无需求文档的粗略想法不适用。