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 登录？"

澄清维度（根据场景选，不必全问）：

目标："最终要实现什么效果？"
范围："只改 A，还是 A/B/C 都改？"
约束："性能/安全/兼容性有特殊要求吗？"
排除："不包括哪些功能？"
上下文："是全新功能还是改现有代码？"

第三步：输出确认表

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

## 需求确认

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

---

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

第四步：等待确认

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

关键原则

快速对齐，不是深度分析 — 3-5 个问题，不超过 5 分钟
简短问句 — 别长篇大论，用"还是"快速二选一
结构化输出 — 确认表让用户一眼看懂
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 登录]

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 登录？"

澄清维度（根据场景选，不必全问）：

目标："最终要实现什么效果？"
范围："只改 A，还是 A/B/C 都改？"
约束："性能/安全/兼容性有特殊要求吗？"
排除："不包括哪些功能？"
上下文："是全新功能还是改现有代码？"

第三步：输出确认表

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

## 需求确认

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

---

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

第四步：等待确认

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

关键原则

快速对齐，不是深度分析 — 3-5 个问题，不超过 5 分钟
简短问句 — 别长篇大论，用"还是"快速二选一
结构化输出 — 确认表让用户一眼看懂
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 登录]