rpiv-loop-brainstorm

> `<rpiv-loop-root>` 解析顺序：环境变量 `RPIV_LOOP_ROOT` -> `CLAUDE_PLUGIN_ROOT` -> 当前插件根目录；均不存在时停止并请用户配置 `RPIV_LOOP_ROOT` 或 `CLAUDE_PLUGIN_ROOT`。 # Brainstorm: 产品需求访谈 ## 前置初始化 首次执行前调用（幂等，已存在则静默跳过）： ```bash uv run --no-project python <rpiv-loop-root>/tools/ensure_project_dod.py ``` 该脚本若发现 `rpiv/dod.yaml` 缺失则从 `<rpiv-loop-root>/tools/dod_template.yaml` 拷贝初始化；已存在则静默跳过。确保项目级 DoD 通用门在后续 RPIV 各阶段可用。 ## 概述 通过结构化的访谈对话，与用户进行头脑风暴，分层、全面地澄清产品需求。对话上下文将作为 `/rpiv-loop:create-prd` 的输入，也可选择将需求摘要保存为文件供 `/rpiv-loop:biubiubiu` 等后续流程使用。 ## 核心原则 - **只谈需求，不谈技术方案**：聚焦于"做什么"和"为什么做"，不涉及"怎么实现" - **访谈式对话**：以提问引导为主，帮助用户系统化思考，发现遗漏 - **分层深入**：从顶层愿景到具体细节，层层递进，确保完整性 - **自然流转**：层次之间不做刻意的阶段确认，保持对话的自然节奏 ## 输入 用户提供的产品想法或方向：$ARGUMENTS 如果 $ARGUMENTS 为空，直接询问用户想要讨论的产品方向。 ## 访谈流程 ### 第一层：愿景（Why & What） 围绕以下四个维度展开，每个维度通过 1-3 个关键问题引导： **1. 要解决的问题** - 当前用户面临什么痛点或不便？ - 这个问题有多普遍、多紧迫？ - 现有的替代方案是什么？为什么不够好？ **2. 核心价值** - 这个产品最独特的价值是什么？ - 用户使用后会获得什么核心收益？ - 一句话描述这个产品的价值主张 **3. 目标用户** - 谁是主要用户？（角色、特征、技术水平） - 是否有次要用户群体？ - 用户在什么情境下会想到使用这个产品？ **4. 产品形态** - 期望的产品载体是什么？（Web应用、桌面软件、CLI工具、移动App、浏览器插件等） - 是否有特定的平台偏好或限制？ - 期望的交互方式是怎样的？（GUI、命令行、API等） **引导方式**：不要一次性抛出所有问题。根据用户的初始描述，识别哪些维度已经隐含回答，只针对模糊或缺失的部分提问。每轮最多问 2-3 个问题，使用 AskUserQuestion 工具以选项形式呈现关键决策点。 ### 第二层：场景（Who & Where） 在愿景明确后，自然过渡到场景梳理： **1. 核心场景枚举** - 梳理用户使用产品的主要场景（通常 3-7 个） - 每个场景用一句话描述："用户在 [情境] 下，需要 [做什么]，期望 [什么结果]" - 确认场景的优先级排序 **2. 产品边界** - 明确哪些是 MVP 必须包含的 - 明确哪些明确不做（至少在第一版不做） - 识别需要推迟到后续版本的功能 **3. 已知约束** - 是否有资源限制？（时间、人力、预算） - 是否有外部依赖？（第三方API、数据源、合规要求） - 是否有已确定的非功能需求？（性能、安全、可用性） **引导方式**：基于愿景层的讨论结果，主动提出可能的场景让用户确认或补充。对于边界问题，可以用"这个功能是否在第一版考虑？"的形式逐项确认。 ### 第三层：细节（How it works） 对第二层梳理出的每个核心场景，逐一深入： **针对每个场景讨论：** **1. 功能细节** - 这个场景包含哪些具体的功能点？ - 每个功能点的输入是什么？输出是什么？ - 是否有配置项或可选参数？ **2. 交互流程** - 用户的操作步骤是怎样的？（步骤1 → 步骤2 → ...） - 关键的交互节点（如确认、选择、输入） - 是否需要反馈或提示？ **3. 异常情况** - 可能出错的地方有哪些？ - 异常情况下用户期望看到什么？ - 边界条件：空输入、超大输入、并发操作等 **引导方式**：按场景优先级逐个讨论。每个场景讨论完毕后自然进入下一个。对于用户描述中明显遗漏的异常情况，主动提出"如果发生 X 情况，你期望怎么处理？" ## 访谈技巧 ### 提问策略 - **开放式引导**：先让用户自由描述，再针对性追问 - **具体化追问**：当回答模糊时，用"能举个具体的例子吗？"引导 - **反向验证**：用"所以你的意思是...对吗？"确认理解 - **补盲提醒**：主动提出用户可能忽略的维度（"你有没有考虑过...的情况？"） ### 对话节奏 - 每轮对话聚焦 1-2 个主题，避免信息过载 - 用户回答简短时，适当追问以获取更多细节 - 用户回答详细时，帮助提炼要点并确认 - 当某个话题讨论充分后，自然引入下一个话题 ### 使用 AskUserQuestion 的场景 以下情况必须使用 AskUserQuestion 工具： - 需要用户在多个方案中做选择时 - 需要确认产品边界（做/不做）时 - 需要确认场景优先级时 ## 结束条件 当以下条件全部满足时，结束访谈： 1. 愿景层四个维度（问题、价值、用户、形态）均已明确 2. 核心场景已枚举并确认优先级 3. 产品边界（做什么/不做什么）已明确 4. 每个核心场景的功能细节、交互流程、异常处理均已讨论 5. 没有明显的遗漏或模糊点 ## 结束输出 访谈完成后，输出结构化的需求摘要（仅展示在对话中，不保存文件）： ``` ## 需求摘要 ### 产品愿景 - **核心问题**：[一句话描述] - **价值主张**：[一句话描述] - **目标用户**：[用户画像] - **产品形态**：[载体 + 交互方式] ### 核心场景（按优先级排序） 1. [场景名]：[一句话描述] 2. [场景名]：[一句话描述] ... ### 产品边界 - **MVP 范围内**：[列表] - **明确不做**：[列表] - **后续版本考虑**：[列表] ### 已知约束 - [约束条件列表] ### 各场景功能要点 #### 场景1：[名称] - 功能点：... - 关键交互：... - 异常处理：... （每个场景重复） ``` 输出摘要后： 1. 询问用户是否有遗漏或需要补充的内容 2. 确认无遗漏后，使用 AskUserQuestion 询问下一步： - **直接创建 PRD**：在当前会话中执行 `/rpiv-loop:create-prd`，从对话上下文提取需求（适合传统 human-in-the-loop 流程） - **保存摘要文件**：将需求摘要保存到 `rpiv/brainstorm-summary-{feature-name}.md`（适合后续使用 `/rpiv-loop:biubiubiu` 全自主开发，或需要跨会话保留需求记录的场景） - **两者都做**：先保存文件，再继续创建 PRD 如果用户选择保存文件，使用以下格式： ```markdown --- description: "需求摘要: {feature-name}" status: pending created_at: {YYYY-MM-DDTHH:MM:SS} updated_at: {YYYY-MM-DDTHH:MM:SS} archived_at: null --- ``` 文件内容使用上方「结束输出」中的需求摘要结构。保存路径：`rpiv/brainstorm-summary-{feature-name}.md`。