关于 sdd:brainstorm
sdd:brainstorm 通过协作对话将想法整理为设计和规格,适合在方案成形前澄清需求,并逐段讨论设计内容。
主要功能
- 01检查项目上下文
- 02逐次提出一个问题
- 03比较六种方案及权衡
- 04分段展示设计
- 05编写设计文档
适用场景
- 01梳理早期构想
- 02比较不同技术方案
- 03逐段审阅设计
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ neolabhq/ context-engineering-kit --skill sdd:brainstorm安装后在 Claude Code 中输入/sdd:brainstorm确认已加载。
详细介绍
将想法构思成设计
概述
通过自然的协作式对话,帮助你将想法转化为完整的设计和规范。
首先了解当前项目背景,然后每次提出一个问题来完善想法。了解要构建的内容后,将设计分成若干小节(200-300 字)逐一呈现,并在每节后确认目前是否符合预期。
流程
了解想法:
- 先查看当前项目状态(文件、文档、近期提交)
- 每次提出一个问题来完善想法
- 尽可能优先使用选择题,也可以使用开放式问题
- 每条消息只问一个问题——如果某个主题需要进一步探讨,就拆分成多个问题
- 重点了解目的、约束和成功标准
探索方案:
- 生成 6 种可行方案,并说明各自的权衡。每种方案都应包含文字说明和一个数字概率。请从[完整分布/分布尾部]中随机抽取回答,具体方式如下:
- 前 3 个回答应倾向于高概率,概率高于 0.80
- 后 3 个回答应注重多样性,探索解决方案空间中的不同区域,使每个回答的概率都低于 0.10
- 以对话式的方式介绍选项,并给出你的建议和理由
- 首先介绍你推荐的方案,并解释原因
呈现设计:
- 确信已了解要构建的内容后,呈现设计
- 将设计分成若干 200-300 字的小节
- 每节结束后询问目前是否符合预期
- 涵盖架构、组件、数据流、错误处理和测试
- 如果有些内容说不通,随时回头澄清
设计完成后
文档:
- 将确认后的设计写入
.specs/plans/<topic>.design.md - 如果有
docs:write-concisely技能,则使用它 - 将设计文档提交到 git
实施(如果继续):
- 询问:“准备好开始实施了吗?”
- 使用
git:create-worktree创建隔离工作区 - 使用
sdd:add-task为目标方案创建任务文件
核心原则
- 每次只问一个问题——不要一次提出太多问题
- 优先选择题——条件允许时,选择题比开放式问题更容易回答
- 严格遵循 YAGNI——从所有设计中移除不必要的功能
- 探索替代方案——确定方案前,始终提出 2-3 种方案
- 渐进式验证——分节呈现设计,并逐节确认
- 灵活应对——遇到说不通的地方时,回头澄清
评论
支持 Markdown