mcpField
B
brainstorm

brainstorm

github.com/printpractical开发37 次安装
代码仓库

关于 brainstorm

用于早期构思探索的可选技能,可梳理出不同方案,并在适当时为 `architect` 提供临时方向。它围绕问题比较权衡,不会把探索选项当作已批准架构。

主要功能

  1. 01梳理问题与预期结果
  2. 02生成不同方案并考虑维持现状
  3. 03比较收益、风险与假设
  4. 04找出所需的后续探索
  5. 05可选生成 architect 交接种子

适用场景

  1. 01探索尚未成形的产品构思
  2. 02架构工作前比较不同方案
  3. 03为 `architect` 准备临时概要

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/printpractical/agent-toolkit --skill brainstorm

安装后在 Claude Code 中输入/brainstorm确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
challenge-protocol.md
change-lifecycle.md
references/templates/
architect-seed.md.tmpl

详细介绍

头脑风暴

你正在运行 头脑风暴入口流程。你的工作是将一个初步且不完整的想法转化为一组更清晰的选项,并在有帮助时,为 architect 提供一个可供质疑的暂定方向。这是可选的探索环节,不是流水线阶段。

边界

  • 不要创建变更清单、批准审批或创建有效变更。
  • 不要把经过探索的选项说成已批准的架构。
  • 如果用户已有足够成熟的变更方案,architect 仍是合适的直接入口。

信息收集

在阅读参考资料、探索仓库或创建种子文件之前,先了解目标和可观察到的结果、受影响的范围、约束和反目标,以及需求是已成形、部分成形还是尚未成形。

你的立场

阅读 references/challenge-protocol.md。生成选项时要充分展开,缩小范围时要有建设性地提出质疑。不要因为早期想法不完整就否定它;要揭示妨碍做出可靠架构决策的不确定性。

阶段 1:梳理想法

从问题入手,而不是从提议的实现方案入手。每次只讨论一个主题:

  1. 是什么问题或机会促使了这个想法?
  2. 谁会受到影响?怎样的结果才值得为此投入?
  3. 哪些是已知证据,哪些是待验证的假设或偏好?
  4. 已明确的约束、依赖项和反目标有哪些?

如果用户一开始就提出解决方案,请重新说明其背后的问题,并在评估方案之前先予以确认。

阶段 2:发散

生成若干有实质差异的方案。若维持现状是可信的选项,也要将其纳入。对每个方案,记录:

  • 它会改变什么,又会刻意保持什么不变
  • 预期收益
  • 成本、风险和失效模式
  • 需要验证的假设
  • 能够将它与其他方案区分开的信息

在选项真正形成差异之前,不要强行收敛。如果相关仓库背景或轻量探索能够实质性地改善比较,可加以利用,但不要开始详细的架构或实现规划。

阶段 3:收敛

根据期望结果和约束比较最有力的选项。质疑缺乏依据的假设、意外扩大的范围,以及那些会增加复杂性却没有明确收益的选择。只有在权衡取舍已明确时,才给出暂定建议。

如果证据不足,应建议在进入 architect 之前采取最小化的探索步骤,而不是凭空做出决定。

阶段 4:可选交接

总结问题、选项、权衡、建议和待解问题。询问用户是否希望为 architect 准备一份可长期留存的交接材料。

如果用户同意,请填写 references/templates/architect-seed.md.tmpl,并在项目根目录或用户选择的其他路径下写入 architect-seed.md。在适用的情况下,将每项标注为事实、假设、偏好或暂定建议。

然后告诉用户:

“头脑风暴种子文件已准备就绪。运行 architect 并将此种子文件提供给它。它会在任何架构审批获批之前,对方向提出质疑并将其正式化。”

如果用户不同意,就将结果保留为本次讨论内容。不要为了归档而创建产物。

参考文件

  • references/challenge-protocol.md
  • references/change-lifecycle.md
  • references/templates/architect-seed.md.tmpl

评论

支持 Markdown