用途
本技能用于生成可直接用于技术设计或实现阶段的 PRD.md。与轻量版一次性生成的 generar-prd 不同,它采用对话式、逐节推进的方式,在真实存在决策的章节提供带权衡的备选方案,确保产出的 PRD 是用户能够辩护的,而非需要重写的晦涩草稿。
主要能力
- 逐节访谈:在写入每一节之前先向用户提问,不假设、不用占位符填充。
- 备选方案:在需要真实决策的章节(如问题定位、成功定义、范围界定)给出 2-3 个带权衡的可行替代方案。
- 假设标注:将代理的假设以 <!-- REVISAR: ... --> 内联标出,便于人工复核。
- 最终写盘:只在全部 8 节验证通过后,才写出 PRD.md。
使用方式
当用户明确要求分步引导式 PRD,或说出“armemos un PRD”“quiero definir bien este producto antes de codear”“necesito un spec de producto conversado”等语句时激活。流程为逐节推进,共 8 节,按模板顺序不得跳过或重排:
- Problema(问题)——真实决策(定位),提供备选
- Usuario objetivo(目标用户)——真实决策(细分),提供备选
- Objetivo / resultado esperado(目标/预期结果)——真实决策(结果 vs 产出),提供备选
- Alcance(范围)——真实决策(边界),提供备选
- No alcance(非范围)——含反模式采集,不提供备选
- Criterios de éxito(成功标准)——真实决策(衡量什么),提供备选
- Casos borde(边界情况)——采集,不提供备选
- Supuestos y riesgos(假设与风险)——采集,不提供备选
每节的操作方式:开场用一句话说明该节重要性;提出 1-3 个具体问题(有真实决策的先给备选);用一句话复述确认理解并询问是否调整;记录回答后进入下一节。8 节全部验证后,使用 assets/prd-template.md 原样拼接 PRD.md,填入已确认的回答,剩余代理假设以 <!-- REVISAR: ... --> 标出,写入项目根目录的 PRD.md(用户可指定其他路径)。结束前提醒:该 PRD 是结构化草稿,模糊处、数字与边界仍需人工复核。
决策门
- 用户想要快速草稿 → 使用 generar-prd(轻量版),而非本技能。
- 用户有想法但问题不清晰 → 跳到 Problema 节,通过提问帮助发现,不推进下一节。
- 用户全部清晰且想快速推进 → 接受简短回答,不强制展开。
- 存在真实决策的章节 → 先给 2-3 个带权衡的备选再接受回答。
- 采集类章节(假设、边界情况)→ 1-2 个深化问题,不给备选。
- 用户已有 PRD 想审阅 → 不使用本技能,请其打开现有 PRD.md 逐节共同审阅。
适用场景
需要一份有据可依、可供评审与实现的产品需求文档时;希望在编码前把产品定义清楚时;需要与环境利益相关方共同确认问题、用户、成果与范围时。
限制
- 必须逐节访谈,不得跳过或重排;在用户输入前写入某节即视为失败模式。
- 不得编造问题、用户或成果;用户不清楚时应通过提问帮助发现,绝不假设。
- 非范围节至少需一条明确排除项,不得写“以上未提及的一切”。
- 成功标准必须可验证,不能是无衡量锚点的形容词。
- 若用户中途结束对话,需将已验证节写入 PRD.md,其余标为 <!-- PENDIENTE -->。
- assets/prd-template.md 为字面模板,不得修改结构或标题。
参考文件
- assets/prd-template.md — 字面模板,不修改,与 generar-prd 相同。
- references/secciones-guia.md — 逐节深化指南:具体问题、带权衡的备选、反模式,以及好回答与坏回答示例。