用途
Brainstorm 用于协作式需求发现与设计框架化,适合处理需求模糊或高风险的开发工作。当需求不清晰、存在多种可能方案,或需要将粗略想法转化为可评审的设计产出时,可以使用该技能。其目标包括:澄清需求与约束、探索带有权衡的备选方案,以及产出具体且经过验证的设计简报或交接给规划阶段的材料。
主要能力
该技能以结构化对话为核心,主要能力体现为六个步骤:
步骤 1:收集项目上下文。 仅加载与当前想法相关的项目上下文。如果 docs/SUMMARY.md 存在则优先阅读;只加载与任务相关的详细文档;优先参考代码规范文档以了解实现约定。如果文档与代码或用户意图冲突,在广泛更改前使用可用的交互式输入/提问工具。同时检查与想法相关的关键实现文件,记录现有架构、依赖和约定带来的约束。此阶段保持聚焦,只收集当前想法所需的内容。
步骤 2:澄清需求。 通过交互式输入/提问工具依次提出针对性问题以消除歧义,聚焦目标与用户价值、范围边界、约束(技术、用户体验、性能、时间线)、成功标准和非目标。不要过早跳入实现细节。
步骤 3:探索方案。 提出 2 至 5 种可行方案,每种包含简短摘要、优点、缺点/风险、复杂度估计和推荐使用条件。以推荐选项开头并解释其为何最符合项目上下文与约束。呈现全部方案后,通过交互式提问工具让用户选择偏好方案,列出摘要选项,例如方案 A、方案 B、方案 C 及“其它(请说明)”,并为推荐方案添加标签以引导用户。
步骤 4:增量呈现设计。 用户选择后,按部分增量呈现设计:1. 基础——问题框架、目标和提议的架构/流程;2. 技术细节——数据模型、接口、错误处理、边界情况和风险;3. 交付——测试/验证策略和上线考虑(如适用)。呈现后立即使用提问工具询问是继续下一步还是调整设计(需要输入文字)。
步骤 5:闭环。 在需求梳理完毕且设计经过验证后,确定下一步动作。使用提问工具向用户呈现三个高层级下一步动作:“立即编写计划”——跳过产出物步骤直接进入带可视化的写计划交接;“编写产出物”——继续编写步骤 6 所述的头脑风暴文档;“立即实现”——如果设计清晰且风险低,用户可选择跳过产出物和规划直接进入实现;“结束会话”——停止,当前对话已产生足够洞察。
步骤 6(可选):编写头脑风暴产出物。 仅在用户在步骤 5 明确选择“编写产出物”后执行。结果保存到标准化位置:目录 docs/.brainstorms/YYMMDD-HHmm-<topic-slug>/;主文件(必需)docs/.brainstorms/YYMMDD-HHmm-<topic-slug>/SUMMARY.md;可选支持文件如 section-01-<slug>.md、section-02-<slug>.md 等。SUMMARY.md 格式严格遵循 references/summary-template.md 中的模板。草案产出物存在后,再次使用提问工具进行验证,选项包括“使用当前产出物和上下文编写计划”、“结束会话——产出物目前足够”以及“需要修改”(自由文本)——收集反馈、修订产出物并重新询问。
使用方式
该技能以会话式交互运行,每个步骤都在同一会话中执行,交互保持轻量且迭代。用户通过交互式输入/提问工具参与需求澄清、方案选择和设计确认。所有产出物均使用与当前会话相同的语言撰写。
适用场景
适用于需求不清晰、存在多种可能方案或属于高风险工作的开发任务,尤其是在需要将粗略想法转化为清晰、可评审的设计简报,或在实现前需要对齐项目规范和约束的场景。
限制
规则明确要求:在此技能的头脑风暴会话中,不编写生产代码或进行实现变更;保持交互轻量且迭代,每一步都应在同一会话中运行;不确定时优先清晰而非完整,应提出后续问题;所有建议需与项目文档和标准保持一致;保持假设显式,不得静默猜测。在编码前先思考:显式呈现假设;若存在多种解释,应全部呈现而非静默选择;若存在更简单的方案,应指出并在有理由时提出异议。