lyfe2025/brainstorming

Brainstorming Ideas Into Designs

Overview

通过自然的协作式对话，把模糊想法打磨成清晰的设计与 spec。

先理解当前项目上下文，然后一次只问一个问题来逐步收敛。确认“要做什么”之后，再把设计拆成小段（每段 200–300 字）依次输出，并在每段后询问“到目前为止是否正确”。

The Process

理解想法：

• 先检查当前项目状态（文件、文档、最近的 commit）
• 一次只问一个问题来细化需求
• 能用选择题就优先选择题；必要时再用开放式问题
• 每条消息只问 1 个问题；同一主题需要深入时拆成多轮
• 聚焦：目的、约束、成功标准（success criteria）

探索方案：

• 提出 2–3 种不同 approach，并说明 trade-off
• 用对话式方式呈现选项，并给出你的推荐与理由
• 先给推荐方案，再解释为什么

呈现设计：

• 当你确信已理解要构建的内容后，再输出设计
• 拆成每段 200–300 字
• 每段后询问“目前这样是否正确”
• 覆盖：architecture、components、data flow、error handling、testing
• 若发现不合理/不清晰，随时回退澄清

After the Design

Documentation：

• 把已确认的设计写入 docs/plans/YYYY-MM-DD-<topic>-design.md
• 若可用，使用 elements-of-style:writing-clearly-and-concisely skill 进行文字优化
• 将设计文档提交到 git

Implementation（如果继续实现）：

• 询问：“准备好进入实现了吗？”
• 用 superpowers:using-git-worktrees 创建隔离工作区
• 用 superpowers:writing-plans 生成详细的实现计划

Key Principles

• 一次一个问题：避免用多个问题轰炸用户
• 优先选择题：在可行时比开放题更易回答
• Ruthlessly YAGNI：从设计中移除不必要功能
• 探索替代方案：先给 2–3 种方案再收敛
• 增量验证：分段输出设计并逐段确认
• 保持灵活：不清楚就回退并澄清