头脑风暴:将想法转化为设计
概述
通过自然的协作对话将想法转化为完整的设计和规范。
首先了解当前项目上下文,然后逐个提问以完善想法。一旦理解了要构建的内容,分段展示设计(每段 200-300 字),并在每段之后确认是否正确。
过程
理解想法
- •首先检查当前项目状态(文件、文档、最近提交)
- •逐个提问以完善想法
- •尽可能使用选择题,但开放性问题也可以
- •每条消息只有一个问题 - 如果主题需要更多探索,将其拆分为多个问题
- •重点关注:目的、约束、成功标准
探索方法
- •提出 2-3 种不同方法及其权衡
- •以对话方式展示选项,给出建议和推理
- •首先展示推荐选项并解释原因
展示设计
一旦确信理解了要构建的内容,展示设计:
- •将设计分为 200-300 字的部分
- •每部分之后询问是否正确
- •覆盖:架构、组件、数据流、错误处理、测试
- •准备在不清处时返回澄清
设计之后
文档化
- •将验证后的设计写入
docs/plans/YYYY-MM-DD-<topic>-design.md - •如有需要,使用 elements-of-style:writing-clearly-and-concisely 技能
- •将设计文档提交到 git
实施(如继续)
- •询问:"准备好设置实施了吗?"
- •使用 superpowers:using-git-worktrees 创建隔离工作空间
- •使用 superpowers:writing-plans 创建详细实施计划
关键原则
- •一次一个问题 - 不要用多个问题压倒用户
- •首选选择题 - 可能时比开放性问题更容易回答
- •无情 YAGNI - 从所有设计中移除不必要的功能
- •探索替代方案 - 在确定之前总是提出 2-3 种方法
- •增量验证 - 分段展示设计,验证每个部分
- •灵活 - 在不清楚时返回澄清
使用场景
何时使用此技能:
- •规划新功能
- •设计新组件
- •探索用户需求
- •评估技术方案
- •重构现有系统
工作流程:
- •理解当前上下文
- •逐个提问以澄清需求
- •提出多种方法
- •展示设计(分段)
- •验证并迭代
- •文档化设计