需求澄清
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/softaworks-agent-toolkit-requirements-clarity。
技能介绍
问题在哪
口头或文档里经常出现「加个登录」「做支付」「做个看板」这类诉求:听起来像需求,却缺少技术栈、集成边界、性能与安全约束,也没有可勾选的验收标准。开发若直接开工,返工往往出在范围与「不算需求里」的分歧上。
技能如何工作
触发后先判断输入是否属于模糊需求(缺技术上下文、无 acceptance criteria、范围不清等)。若用户已给出具体文件路径、代码片段或带复现步骤的 bug,技能不会进入澄清模式。
核心流程分四步:
- 初评:解析诉求、生成
kebab-case特性名与 PRD 版本,并对清晰度打 0~100 分。 - 缺口扫描:按功能范围、用户交互、技术约束、业务价值四个维度找空洞。
- 分轮追问:每轮 2~3 个问题,基于上一轮答案递进;每答一轮更新分数,分数 ≥90 才进入成稿。
- PRD 落盘:用 Write 工具写出
./docs/prds/{feature_name}-v{version}-prd.md,包含可勾选验收项与可分阶段执行的任务。
边界与注意点
这是需求澄清与规格化工具,不是改代码或定位线上故障的助手。澄清轮次会写在 PRD 里,适合作为评审与交接材料;若你期望一次性问完所有问题,技能的设计恰恰相反——刻意控制每轮信息量,避免把业务方问懵。
使用场景
- 业务方只提了「做用户管理」,开发前需要把 MVP 范围、边界外项和异常场景问清楚
- 新功能没有成功指标和验收条件,希望在写第一行代码前产出可勾选的验收清单
- 跨团队功能涉及登录与支付,但需求描述未写集成点与合规约束,需结构化补全
- 迭代启动会议后只有一句话需求,需要落成带分阶段任务的 PRD 供评审与交接
适合人员
- 接手口头需求的研发负责人,要把「实现支付」拆成技术约束、接口与错误处理后再排期
- 写不出验收标准的产品经理,需要用分轮追问把交互输入输出和失败场景写进文档
- 负责对外交付的技术撰稿人,要把模糊功能单整理成 `./docs/prds/` 下版本化 PRD
- 在需求评审中发现范围含糊的技术骨干,希望用百分制评分判断何时可以结束澄清