mcpField
S
sdd:brainstorm

sdd:brainstorm

github.com/neolabhq开发1.8k509 次安装10 周前更新
代码仓库

关于 sdd:brainstorm

sdd:brainstorm 通过协作对话将想法整理为设计和规格,适合在方案成形前澄清需求,并逐段讨论设计内容。

主要功能

  1. 01检查项目上下文
  2. 02逐次提出一个问题
  3. 03比较六种方案及权衡
  4. 04分段展示设计
  5. 05编写设计文档

适用场景

  1. 01梳理早期构想
  2. 02比较不同技术方案
  3. 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