SuperAPI AI 工具集

brainstorming

编程与开发

查看项目

更新于 11-13 20:56

技能介绍

用途

该技能用于在编写代码或制定实现计划之前,把粗略想法细化为完整的设计与规格。它通过自然的协作式对话推进:先理解当前项目背景,再逐个提问细化想法;在明确要构建的内容后,按小节(每节 200-300 字)呈现设计,并在每节后确认方向是否正确。开始时需声明:“I'm using the brainstorming skill to refine this idea into a design.”

主要能力与流程

技能使用 TodoWrite 为各阶段建立待办并标记进度:理解(澄清问题空间)、探索(调研替代方案)、呈现(记录拟定设计)、交接(转入实现)。

  • 阶段一:理解想法。先阅读相关文件、文档和近期提交,了解现有情况;再用 AskUserQuestion 收集范围(MVP/原型、生产级、增强现有功能)、目标用户(终端用户、开发者、两者)、约束(性能关键、向后兼容、安全敏感、外部依赖,可多选),最后以自由问答逐个澄清目的、成功标准等。
  • 阶段二:探索方案。提出 2-3 个方案并简述权衡,先给出推荐及理由,再用 AskUserQuestion 让用户选择。
  • 阶段三:呈现设计。按架构、组件、数据流、错误处理、测试等分节呈现,每节后用 AskUserQuestion 收集“Looks good / Minor tweaks / Needs rethinking”反馈,必要时回退到阶段二。
  • 阶段四:设计之后。通过 AskUserQuestion 决定文档处理(保存并提交、仅保存、跳过),若保存则写入 docs/plans/YYYY-MM-DD-<topic>-design.md;再决定实现交接方式(建立 worktree、仅写计划、到此为止),并相应调用 workflow:git-worktrees、workflow:writing-plans。

使用方式与原则

结构化问题用于决策,自由对话用于发现;一次只问一个问题;设计中去掉不必要功能(YAGNI);始终先提出 2-3 个方案;分节增量验证;必要时回头澄清。若问题高度依赖上下文、选项不自然或需要开放式探索,则改用自由文本。设计文档可配合 elements-of-style:writing-clearly-and-concisely 技能。

适用场景

适用于新功能构思、需求模糊时的方案探索、编码前设计确认,以及需要产出设计文档并交接实现计划的开发流程。

限制

该技能依赖 TodoWrite、AskUserQuestion 等工具及相关工作流技能;资料未说明其独立运行方式、平台支持范围或收费信息。