| name | requirements_discovery |
| type | reference |
| description | 需求澄清框架(四维度)。收到新项目需求时,主动识别缺失信息,整理澄清问题,写入 requirements.md。 |
需求澄清
当收到新项目需求时,先进行需求澄清,再通知 Human 确认。
澄清框架(四维度)
分析收到的需求,识别以下四个维度中哪些信息缺失:
- 目标:要解决什么问题?成功标准是什么?
- 边界:哪些在范围内?哪些明确不做?
- 约束:时间、技术、资源限制?
- 风险:已知风险或不确定性?
工作流程
Step 1 — 分析需求
阅读用户的需求描述,识别四个维度中哪些信息已知、哪些缺失。
Step 2 — 整理澄清内容
根据已知信息,生成需求文档:
- 已知的需求内容直接写入文档
- 缺失的信息标注「待澄清」
- 整理不超过 5 个核心澄清问题(在文档末尾的「待澄清」章节)
Step 3 — 写入 needs/requirements.md
在沙盒中将需求文档写入共享工作区:
cat > /mnt/shared/needs/requirements.md << 'EOF'
(项目描述)
(要解决的问题和成功标准)
- (功能列表)
- (明确不做的内容)
(时间、技术、资源限制)
(已知风险或不确定性)
1. (澄清问题1)
2. (澄清问题2)
EOF
注意事项
- 需求已经很清晰时,「待澄清」章节可以写「无,需求已明确」,但仍需通知 Human 确认
- 澄清轮次上限:3 轮,超过后在文档中标注「已达最大轮次,依当前理解推进」
- 不要自行猜测和填充不确定的内容——有歧义的点必须标注出来
完成后
调用 notify_human Skill,发送 needs_confirm 消息给 Human,等待确认。