mcpField
G
generar-prd-conversacional

generar-prd-conversacional

github.com/adminoryslabs开发045 次安装2 天前更新
代码仓库

关于 generar-prd-conversacional

这项对话式技能按顺序引导用户完成并确认 PRD.md 的八个部分,适合希望共同梳理需求、产出可审阅规格的产品团队。它会呈现可行方案及权衡,并标记 Agent 的假设。

主要功能

  1. 01逐项访谈并完成八个部分
  2. 02为关键决策展示方案权衡
  3. 03标记 Agent 假设供确认
  4. 04确认完成后写入 PRD.md

适用场景

  1. 01在实施前梳理产品需求
  2. 02确定范围与成功标准
  3. 03准备可审阅的产品规格

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/adminoryslabs/armory --skill generar-prd-conversacional

安装后在 Claude Code 中输入/generar-prd-conversacional确认已加载。

附带文件assets/prd-template.mdreferences/secciones-guia.md

详细介绍

PRD 生成器(对话式)

目标

与用户一次讨论一个章节,最终产出可直接用于技术设计或实现的 PRD.md。与 generar-prd 技能(轻量版,一次完成)不同,此技能会:

  • 在编写每个章节之前进行访谈——不自行假设,也不使用占位符填充内容。
  • 在确实需要做出决策的章节中(例如如何界定问题、如何定义成功、范围包含哪些内容等),提供带有取舍说明的备选方案。
  • 用 `` 标记 Agent 的假设,供用户在审阅时确认。
  • 等 8 个章节全部通过验证后,才在最后写入 PRD.md——不会提前写入。

最终产出是一份用户能够为其内容辩护的 PRD,而不是一份晦涩、需要用户重写的草稿。

激活条件

当用户明确要求以引导式、循序渐进的方式编写 PRD,或以“我们来一起编写 PRD”“我想在编码前把产品定义清楚”“我需要一份通过对话编写的产品规范”等说法开始时,使用此技能。如果用户只想快速起草一份初稿,则使用轻量版技能 generar-prd。

硬性规则

  • 按模板顺序依次处理 8 个章节。不得跳过或调整章节顺序。
  • 编写每个章节之前,等待用户回复。未获得用户输入就编写章节,是此技能的失效模式——相当于退回轻量模式。
  • 不得臆造问题、用户或预期结果。如果用户还不清楚,就通过提问帮助其厘清——绝不自行假设。
  • 对 Agent 的所有假设都必须在行内用 `` 标记。PRD 必须便于审阅,不得呈现为已完成的文档。
  • 备选方案必须确实适用于当前项目——不能用手册式选项绕过决策,而不向用户呈现。
  • 如果用户在流程中途结束对话,则将部分进度保存到 PRD.md:保留已验证的章节,其余章节标记为 ``。

决策关口

情况操作
用户要求快速起草使用 generar-prd(轻量版),而非此技能
用户有想法,但问题尚不明确跳转到“问题”章节,通过提问帮助用户厘清,不要继续到下一章节
用户对所有内容都很明确,希望加快进度接受简短回答——如果回答充分,不要强迫用户展开说明
章节涉及实际决策(问题、成功、范围)接受回答前,提供 2-3 个附带取舍说明的备选方案
章节用于收集信息(假设、边缘情况)提出 1-2 个深入问题,不提供备选方案
用户已有 PRD 并想要审阅不使用此技能——请用户打开现有的 PRD.md,然后逐章节共同审阅

工作流

开始前,先确认用户是否想采用对话式流程。如果确认,则按顺序逐一完成 8 个部分,每轮一个。对于每个部分:

  1. 开启:用 1 行说明该部分为何重要,不提供教程。
  2. 深入探讨:提出 1-3 个具体问题。如果该部分涉及实际决策,则在提问前提供 2-3 个备选方案及其权衡。参见 references/secciones-guia.md 中的指南。
  3. 确认:用 1 行复述以确认你理解正确,并询问用户是否想在结束前调整。
  4. 结束:记录回答并进入下一部分。不要汇总——PRD 会随着流程推进逐步在用户脑中成形。

8 个部分及其顺序和预期交互类型如下:

#部分类型是否提供备选方案?
1问题实际决策(界定问题)是
2目标用户实际决策(细分用户)是
3目标/预期结果实际决策(结果与产出)是
4范围实际决策(划定边界)是
5不在范围内收集信息并指出反模式否
6成功标准实际决策(衡量什么)是
7边界情况收集信息否
8假设与风险收集信息否

确认完 8 个部分后:

  1. 使用 assets/prd-template.md 组装 PRD.md——原样复制模板,不修改结构或标题。
  2. 用已确认的回答填充每个部分。如果仍有 Agent 未明确说明的假设,用 `` 标记。
  3. 写入磁盘上的 PRD.md(项目根目录),除非用户指定其他路径。
  4. 结束时提醒用户:PRD 是一份结构化草稿——实际审核(歧义、数字、边界)仍由人来完成。

质量检查

结束前,静默检查以下内容:

  • 8 个部分均已包含,且没有空项——每项至少有一个要点/想法,即使内容很简略。
  • “不在范围内”至少包含一项明确排除的内容(不能写成“以上未提及的所有内容”)。
  • 成功标准可验证,不能只是没有衡量依据的形容词。
  • Agent 的所有假设都已用 `` 标记。
  • 如果在完成所有部分之前就结束,则在文件中用 `` 标记剩余部分。

参考资料

  • assets/prd-template.md——模板原文,不可修改。与 generar-prd 中的模板完全相同。
  • references/secciones-guia.md——各部分的深入探讨指南:具体问题、带权衡的备选方案、反模式,以及好坏回答示例。

评论

支持 Markdown