用途:brainstorm-design 用于在实现之前,将粗略想法转化为已验证、达到生产级的设计。它通过系统化的协作对话,探索上下文、澄清需求、提出带权衡的备选方案,并在写任何代码前取得明确批准,从而避免过早实现。
主要能力:产出设计文档作为实现的唯一依据;要求至少记录 2-3 种方案及其权衡;强制应用 YAGNI(聚焦最小可行方案)与 DRY(引用既有模式而非重造);在整个流程中不写任何实现代码。
使用方式:流程分五阶段。第一阶段探索上下文,审阅相关文件、文档、近期提交与既有架构,识别约束与可用的最佳实践,并区分已知与待澄清事项。第二阶段通过对话澄清,一次只问一个问题,优先使用多选题,边问边总结确认理解。第三阶段探索备选方案,先给出推荐项并说明理由,列出各方案优缺点与适用场景,再由用户反馈。第四阶段逐节呈现设计(按复杂度调整篇幅),覆盖架构、组件、数据流、错误处理、测试策略等。第五阶段将设计写入文档并提交版本控制:默认路径为 docs/design-decisions/YYYY-MM-DD-<topic>.md,若项目中存在 .ai-cortex/artifact-norms.yaml 或 docs/ARTIFACT_NORMS.md,则使用项目约定路径;文档含 YAML front-matter(artifact_type、created_by、lifecycle、created_at)及目标、架构、组件、数据流、错误处理、测试策略、权衡、验收标准等章节。
适用场景:功能规划、架构决策、需求澄清、既有设计草案的验证,以及设计阶段应用领域最佳实践。
限制:设计经批准前不得调用实现类技能、写代码、搭建项目或采取实现动作;不得假设“太简单不需要设计”,每个项目都需经此流程;不得一次抛出多个问题;不得一次性呈现整份设计;不理解时应提问而非猜测。实现计划、代码编写、代码审查、调试与部署均由其他技能处理,本技能止于设计通过并交付。