playbook/templates/prompts/coding/clarify.template.md

130 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 需求澄清模板
## 何时使用
- 需求描述不明确
- 存在多种理解方式
- 缺少关键信息
---
## 澄清步骤
### 1. 理解当前需求
**复述需求**
```text
我理解你的需求是:[用自己的话复述]
```
**识别歧义点**
- 歧义 1[描述不明确的地方]
- 歧义 2[可能有多种理解的地方]
---
### 2. 提出澄清问题
**问题模板**
> 只问阻塞问题,最多 12 个;优先给出选项让用户选择。
#### 功能范围
- 这个功能是否包括 [场景 A]
- 是否需要支持 [边界情况 B]
- 优先级如何?必须有 vs 可选
#### 行为细节
- 当 [条件 X] 时,应该 [行为 Y] 还是 [行为 Z]
- 如果 [异常情况],如何处理?
- 是否需要与 [现有功能] 保持一致?
#### 技术约束
- 是否有性能要求?
- 是否有兼容性要求?
- 是否有安全要求?
---
### 3. 提供选项
**选项格式**
**选项 A**[方案描述]
- 优点:[列出优点]
- 缺点:[列出缺点]
- 适用场景:[什么情况下选这个]
**选项 B**[方案描述]
- 优点:[列出优点]
- 缺点:[列出缺点]
- 适用场景:[什么情况下选这个]
**推荐**[推荐哪个选项,为什么]
---
### 4. 确认理解
**确认清单**
- [ ] 功能范围明确
- [ ] 行为细节清晰
- [ ] 技术约束已知
- [ ] 优先级确定
- [ ] 验收标准明确
---
## 示例
### 需求
```text
实现 XXX 功能
```
### 澄清过程
**复述需求**
```text
我理解你的需求是:为 YYY 添加 XXX 功能,
用于 ZZZ。
```
**识别歧义点**
- 歧义 1XXX 是只读还是可写?
- 歧义 2是否需要支持所有场景
**澄清问题**
- 是否需要支持 [场景 A]
- 当 [条件 X] 时,应该如何处理?
**提供选项**
**选项 A**:完整实现
- 优点:功能完整
- 缺点:开发周期长
**选项 B**:核心功能
- 优点:快速交付
- 缺点:功能有限
**推荐**:选项 A因为 [原因]。
---
**最后更新**{{DATE}}