SuperAPI AI 工具集

brainstorming

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

brainstorming 是一个面向 AI 编程助手的设计前置技能,核心目的是在动手实现之前先把“要做什么、为什么这样做”想清楚,并取得用户的明确批准。

用途 该技能适用于任何创造性工作开始之前,包括创建功能、构建组件、添加功能或修改行为。它把设计探索设为硬性前置条件:在呈现设计并获得用户批准之前,不得编写代码、搭建脚手架或调用任何实现类技能。

主要能力

  1. 项目上下文探索:先阅读相关代码与文档,理解现有实现与约束。
  2. 需求澄清:一次只问一个澄清问题,并优先使用多选题形式,降低用户回答成本。
  3. 方案对比:提出 2-3 种不同方案,说明各自的权衡,并给出推荐方案。
  4. 分段设计评审:按架构、组件、数据流、错误处理、测试等章节逐段呈现设计,每段获得批准后再进入下一段。
  5. 设计文档产出:将达成一致的设计写入 docs/specs/YYYY-MM-DD-<topic>-design.md。
  6. 规格自审:删除占位符、修正矛盾与歧义、检查范围,并对涉及多子系统的范围标记拆分。
  7. 用户批准关卡:由用户审阅书面规格,作为进入实现前的批准关卡。

使用方式 该技能以流程规则的形式被调用,不涉及具体安装命令或代码接口。使用时按上述流程逐步推进:先读代码与文档,再逐个提问澄清,然后给出方案选项与推荐,接着分段呈现设计并逐段确认,最后写入规格文件、自审并交由用户审阅。

适用场景 适合在功能开发、组件构建、功能扩展或行为变更等创造性工作启动前使用,尤其适合需求尚不明确、存在多种实现路径、或涉及多个子系统需要提前拆分的项目。

限制与原则 该技能强调严格执行 YAGNI,避免过度设计;采用增量验证;即使是被认为“简单”的项目,也应在构建前经过一次简短的设计评审。资料未提供具体的收费、价格、平台支持范围或效果数据。该技能源自 github.com/obra/superpowers(MIT 许可),为 corlinman 市场做了精简与署名。