Design brainstorming

何时使用

在任何创造性或建设性工作（新功能、架构、行为变更）动手实现之前，用本技能把原始想法转化为清晰、经过验证的设计与规格。它专治四种病：过早实现、隐藏假设、方案错位、系统脆弱。

激活本技能期间，你的角色是设计引导者与资深评审，不是建造者：

• 不写实现、不写代码、不改变行为
• 不臆造投机性功能
• 不带未声明的隐藏假设
• 不跳步抢跑

核心是"把节奏放慢到刚好能把事做对"。

不该用的边界：

• 需求已明确、只待编码或调试 —— 直接进入实现，别走这套流程
• 纯执行类任务（修 bug、跑脚本、改配置）
• 一次性琐碎改动，走完整流程反而是浪费

步骤

1. 理解当前上下文（强制第一步）

提问之前先做功课：审阅现有项目状态（文件、文档、计划、既往决策），分清"已存在"与"被提议"，记下那些看似隐含但未经确认的约束。此阶段不要设计。

2. 理解想法（一次只问一个问题）

目标是共同的清晰，不是速度。

• 每条消息只问一个问题
• 尽量用多选题，仅在必要时才用开放式提问
• 话题需要深挖时，拆成多个问题分别问

聚焦：目的、目标用户、约束、成功标准、明确的非目标。

3. 非功能性需求（强制）

必须显式澄清或提出假设：性能预期、规模（用户/数据/流量）、安全与隐私约束、可靠性/可用性、维护与归属。用户不确定时，给出合理默认值并明确标注为"假设"。

4. 理解锁定（硬性闸门）

提出任何设计之前必须暂停，产出：

• 理解摘要：5–7 条要点，覆盖 做什么 / 为什么 / 给谁用 / 关键约束 / 明确非目标
• 假设清单：列出全部假设
• 待解问题：列出未决问题

然后逐字询问：

"这是否准确反映了你的意图？进入设计前，请确认或更正任何内容。"

未获明确确认，不得继续。

5. 探索设计方案

确认理解后：提出 2–3 个可行方案，先给推荐项，清晰说明权衡（复杂度、可扩展性、风险、维护成本）。避免过早优化 —— YAGNI 要狠。此处仍非最终设计。

6. 增量呈现设计

• 每段控制在 200–300 字以内

• 每段之后追问：

  "到这里看起来对吗？"

按相关性覆盖：架构、组件、数据流、错误处理、边界情况、测试策略。

7. 决策日志（强制）

全程维护一份滚动决策日志，每条记录：决定了什么 / 考虑过哪些替代方案 / 为什么选这个。该日志须保留用于归档。

设计之后

• 文档化：设计通过验证后，写入持久共享格式（如 Markdown），包含 理解摘要 + 假设 + 决策日志 + 最终设计，按项目标准流程落盘。
• 交接实现（可选）：文档完成后再问"准备好进入实现了吗？"。同意则制定显式实现计划、隔离工作区（若工作流支持）、增量推进。

指令

退出头脑风暴模式的硬性退出条件（必须全部满足）：

• 理解锁定已确认
• 至少一个设计方案被明确接受
• 主要假设已记录
• 关键风险已被知晓
• 决策日志完整

任一条件未满足 → 继续打磨，不得进入实现。

不可妥协的关键原则： 一次只问一个问题 · 假设必须显式 · 探索替代方案 · 增量验证 · 清晰优于花哨 · 愿意回退澄清 · YAGNI 要狠。

若设计属于高影响、高风险或需要更高置信度，必须在实现前把定稿设计与决策日志交接给 multi-agent-brainstorming（多智能体头脑风暴）技能。

示例

用户："我想给后台加一个导出报表的功能。"

正确做法（按本技能）：

1. 先看现有项目有没有相关导出/报表代码、数据模型、权限体系（步骤 1）。
2. 一次一个多选题澄清，例如："导出触发方式？(A) 用户手动点击 (B) 定时自动 (C) 两者都要"（步骤 2）。
3. 追问非功能性需求："单次导出预计数据量级？(A) 千行内 (B) 万级 (C) 百万级以上" —— 不同量级直接决定是否需异步任务（步骤 3）。
4. 给出理解摘要 + 假设 + 待解问题，请用户确认（步骤 4 硬闸门）。
5. 确认后提 2–3 方案，先推荐："方案 A 同步生成（简单，适合小数据量）；方案 B 异步队列 + 通知（可扩展，复杂度高）……"（步骤 5）。
6. 分段呈现设计，每段问"到这里对吗"，全程记决策日志（步骤 6、7）。

错误做法：用户一说就直接开始写导出代码 —— 这正是本技能要阻止的"过早实现"。

注意事项

• 第一步不可跳过：不审上下文就提问，会重复发明已有约束，浪费往返。
• 理解锁定是硬闸门，不是礼节性确认：没拿到用户明确"确认"二字，不许进入设计。
• 假设必须显式标注，不能默默替用户做决定（"silent assumptions" 是明令禁止项）。
• 增量验证：设计分段呈现并逐段确认，避免一口气抛出大块设计后才发现方向错了。
• 本技能产出的是设计与规格，不能替代环境特定的验证、测试或专家评审。
• 若必需的输入、权限、安全边界或成功标准缺失，应停下来要求澄清，而非自行假定。

互见

• multi-agent-brainstorming（多智能体头脑风暴）：高风险/高影响设计的下一步交接目标。
• 实现阶段技能：本技能完成并文档化后，方可交接给具体的编码/实现工作流。

---

采编自 sickn33/antigravity-awesome-skills（MIT 许可）。