# Common Requirement Clarification

> 需求澄清技能，帮助团队明确和细化业务需求

- Skill: `bage2014/common-requirement-clarification` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bage2014/common-requirement-clarification`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bage2014/common-requirement-clarification/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bage2014 (https://skillmd.com/u/bage2014)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bage2014/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）实现需求的自动化同步。
## 触发条件