common-requirement-clarification

# 需求澄清技能 ## 功能描述 提供需求分析和澄清能力，帮助团队明确业务需求的细节，确保需求的完整性、一致性和可测试性。 ## 何时使用 在以下情况调用此技能： - 需求文档模糊或不完整时 - 需要确认需求的业务背景和目标 - 需要细化需求的验收标准 - 需要识别需求的依赖关系和风险 ## 核心功能 - **需求分解**：将模糊需求分解为具体、可测试的用户故事 - **疑问收集**：识别需求中的模糊点和待确认项 - **验收标准定义**：帮助定义清晰的验收标准 - **依赖分析**：识别需求之间的依赖关系 - **风险评估**：评估需求实现的技术风险和业务风险 - **头脑风暴**：基于 Brain Storm 模式，激发创意和解决方案 ## 头脑风暴模块 ### 功能描述 头脑风暴模块基于 Super Power 的 Brain Storm 模式，在需求新提出时自动触发，帮助团队从多角度思考需求，激发创新解决方案。 ### 触发条件 - 需求首次提出时自动触发 - 用户明确请求头脑风暴时触发 - 需求陷入僵局需要创新思路时触发 ### 头脑风暴流程 ``` 需求提出 → 发散思考 → 收敛筛选 → 方案评估 → 输出创意方案 ``` ### 头脑风暴方法 #### 1. 发散思考阶段 - **5W1H 分析**：从 Who、What、When、Where、Why、How 六个维度分析需求 - **反向思考**：假设需求不存在会怎样？有什么替代方案？ - **类比思考**：参考类似场景的解决方案 - **极端假设**：假设资源无限/资源为零的情况下如何实现？ #### 2. 收敛筛选阶段 - **投票筛选**：对创意方案进行投票 - **可行性评估**：评估方案的技术可行性和业务价值 - **优先级排序**：按价值和可行性进行优先级排序 ### 头脑风暴输出 ```json { "brainstormId": "BS-001", "requirementId": "REQ-001", "ideas": [ { "id": "IDEA-001", "title": "创意方案标题", "description": "创意方案详细描述", "source": "5W1H分析", "voteCount": 5, "feasibility": "高", "value": "高", "priority": 1 } ], "selectedIdeas": ["IDEA-001", "IDEA-003"], "nextSteps": ["方案细化", "技术评审"] } ``` ### 头脑风暴检查清单 | 检查项 | 说明 | 状态 | |--------|------|------| | 多样性 | 是否考虑了多种解决方案 | ✅/❌ | | 创新性 | 是否有突破常规的思路 | ✅/❌ | | 可行性 | 方案是否在技术和资源范围内 | ✅/❌ | | 价值性 | 方案是否带来实际业务价值 | ✅/❌ | ## 输入参数 | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | requirementText | String | 是 | 原始需求描述文本 | | businessContext | String | 否 | 业务背景说明 | | stakeholders | List\<String\> | 否 | 相关干系人列表 | | deadline | String | 否 | 需求截止时间 | ## 输出格式 ```json { "status": "SUCCESS", "originalRequirement": "原始需求文本", "clarifiedPoints": [ { "question": "需要澄清的问题", "suggestion": "建议的澄清方向", "priority": "高/中/低" } ], "userStories": [ { "id": "US-001", "title": "用户故事标题", "description": "作为角色，我希望功能，以便价值", "acceptanceCriteria": ["条件1", "条件2"] } ], "dependencies": ["依赖需求ID", "依赖系统"], "risks": [ { "description": "风险描述", "level": "高/中/低", "mitigation": "缓解措施" } ] } ``` ## 需求澄清流程 ``` 原始需求 → 需求分析 → 疑问识别 → 验收标准定义 → 依赖分析 → 风险评估 → 输出澄清结果 ``` ### 详细步骤 1. **需求分析**：解析需求文本，提取关键信息 2. **疑问识别**：识别模糊、歧义或缺失的信息点 3. **验收标准定义**：帮助定义可测试的验收条件 4. **依赖分析**：识别与其他需求或系统的依赖关系 5. **风险评估**：评估技术和业务风险 ## 需求质量检查清单 | 检查项 | 说明 | 状态 | |--------|------|------| | 完整性 | 需求是否包含所有必要信息 | ✅/❌ | | 清晰性 | 需求描述是否清晰无歧义 | ✅/❌ | | 可测试性 | 是否有明确的验收标准 | ✅/❌ | | 可行性 | 技术上是否可行 | ✅/❌ | | 优先级 | 是否明确需求优先级 | ✅/❌ | ## 实践指南 ### 用户故事模板 ``` 作为 <角色>， 我希望 <功能/行为>， 以便 <价值/收益>。 验收标准： - 场景1：... - 场景2：... ``` ### 需求澄清提问清单 1. **目标与价值**：这个需求要解决什么问题？带来什么价值？ 2. **用户角色**：谁会使用这个功能？用户场景是什么？ 3. **功能边界**：这个功能包含什么？不包含什么？ 4. **业务规则**：有哪些业务规则需要遵守？ 5. **异常处理**：异常情况如何处理？ 6. **数据需求**：需要哪些数据？数据来源在哪里？ 7. **性能要求**：有没有性能指标要求？ 8. **安全合规**：有没有安全或合规要求？ ## 核心组件 | 组件 | 职责 | 描述 | |------|------|------| | RequirementAnalyzer | 需求分析器 | 解析和分析需求文本 | | QuestionExtractor | 问题提取器 | 识别需求中的模糊点 | | StoryGenerator | 用户故事生成器 | 生成结构化的用户故事 | | RiskAssessor | 风险评估器 | 评估需求实现风险 | ## 配置要求 无需额外配置，基于规则引擎进行需求分析。 ## 扩展指南 ### 添加自定义检查规则 1. 在规则引擎中添加新的检查规则 2. 定义规则的触发条件和处理逻辑 3. 更新需求质量检查清单 ### 集成外部工具 可集成需求管理工具（如 Jira、Azure DevOps）实现需求的自动化同步。 ## 触发条件