---
name: clarify-requirements
description: Use when user corrects your understanding multiple times (≥2 times) — stops to clarify requirements before continuing
---

# 需求澄清

轻量级需求对齐流程。当发现用户多次纠正时，停下来快速对齐理解。

## 触发条件

**自动触发（LLM 判断）**：
- 用户明确说"不对"/"不是这样"/"理解错了"
- 用户用"应该是..."重新描述（说明前几次没理解对）
- 同一个需求的变体描述出现 ≥2 次（说明理解有偏差）

**手动触发**：
- 用户明确要求"重新梳理"/"没理解对"/"需求澄清"

## 流程

### 第一步：停止当前任务

```
立即停止当前正在做的任何事
```

### 第二步：快速澄清（3-5 个问题）

用**简短问句**快速对齐，不是长篇大论：

```
❌ 错误："请问您说的登录功能具体是指..."
✅ 正确："是改密码校验，还是改 SSO 登录？"
```

**澄清维度**（根据场景选，不必全问）：
1. **目标**："最终要实现什么效果？"
2. **范围**："只改 A，还是 A/B/C 都改？"
3. **约束**："性能/安全/兼容性有特殊要求吗？"
4. **排除**："不包括哪些功能？"
5. **上下文**："是全新功能还是改现有代码？"

### 第三步：输出确认表

澄清完成后，输出结构化的需求确认表：

```markdown
## 需求确认

| 维度 | 内容 |
|------|------|
| **目标** | [一句话总结] |
| **涉及范围** | [具体文件/模块] |
| **约束条件** | [性能/安全/兼容性等] |
| **排除项** | [明确不做的事情] |

---

**以上理解是否正确？确认后我继续执行。**
```

### 第四步：等待确认

- **手动模式**：等待用户说"对"/"yes"/"确认"/"继续"
- **AUTO 模式**：
  - 如果理解清晰 → 自问自答（假设 yes）
  - 如果**仍然不确定** → 停下来问用户（不要强行继续）

## 关键原则

1. **快速对齐，不是深度分析** — 3-5 个问题，不超过 5 分钟
2. **简短问句** — 别长篇大论，用"还是"快速二选一
3. **结构化输出** — 确认表让用户一眼看懂
4. **AUTO 模式兜底** — 不确定就停下来问用户，不要"自以为对"

## 完成后

- 用户确认后，**恢复之前中断的任务**
- 不需要重新走 brainstorming/writing-plans（除非用户明确要求）
- 如果澄清后发现需求很大，建议用户走完整 dev-workflow

## 示例

### 场景：用户多次纠正登录逻辑

```
用户: "改登录逻辑"
AI: [开始改密码校验]
用户: "不对！是改 SSO"
AI: "看起来我理解有偏差，需要重新梳理一下"

[触发 clarify-requirements]

AI: "快速确认几个问题：
1. 是改 OAuth 2.0 还是 CAS？
2. 只改登录流程，还是改会话管理？
3. 兼容现有账号体系吗？"

用户: "OAuth 2.0，只改登录，兼容现有账号"

AI: 
## 需求确认

| 维度 | 内容 |
|------|------|
| **目标** | 将登录从密码校验改为 OAuth 2.0 SSO |
| **涉及范围** | 登录模块（不包括会话管理） |
| **约束条件** | 兼容现有账号体系 |
| **排除项** | 会话管理、账号迁移 |

---

**以上理解是否正确？确认后我继续执行。**

用户: "对，继续"
AI: [恢复修改 OAuth 2.0 登录]
```
