SuperAPI AI 工具集

generar-prd-conversacional

写作与研究

查看项目

更新于 10-15 10:04

技能介绍

用途

本技能用于生成可直接用于技术设计或实现阶段的 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 节,按模板顺序不得跳过或重排:

  1. Problema(问题)——真实决策(定位),提供备选
  2. Usuario objetivo(目标用户)——真实决策(细分),提供备选
  3. Objetivo / resultado esperado(目标/预期结果)——真实决策(结果 vs 产出),提供备选
  4. Alcance(范围)——真实决策(边界),提供备选
  5. No alcance(非范围)——含反模式采集,不提供备选
  6. Criterios de éxito(成功标准)——真实决策(衡量什么),提供备选
  7. Casos borde(边界情况)——采集,不提供备选
  8. 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 — 逐节深化指南:具体问题、带权衡的备选、反模式,以及好回答与坏回答示例。