关于 generar-prd-conversacional
这项对话式技能按顺序引导用户完成并确认 PRD.md 的八个部分,适合希望共同梳理需求、产出可审阅规格的产品团队。它会呈现可行方案及权衡,并标记 Agent 的假设。
主要功能
- 01逐项访谈并完成八个部分
- 02为关键决策展示方案权衡
- 03标记 Agent 假设供确认
- 04确认完成后写入 PRD.md
适用场景
- 01在实施前梳理产品需求
- 02确定范围与成功标准
- 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-3 个具体问题。如果该部分涉及实际决策,则在提问前提供
2-3 个备选方案及其权衡。参见
references/secciones-guia.md中的指南。 - 确认:用 1 行复述以确认你理解正确,并询问用户是否想在结束前调整。
- 结束:记录回答并进入下一部分。不要汇总——PRD 会随着流程推进逐步在用户脑中成形。
8 个部分及其顺序和预期交互类型如下:
| # | 部分 | 类型 | 是否提供备选方案? |
|---|---|---|---|
| 1 | 问题 | 实际决策(界定问题) | 是 |
| 2 | 目标用户 | 实际决策(细分用户) | 是 |
| 3 | 目标/预期结果 | 实际决策(结果与产出) | 是 |
| 4 | 范围 | 实际决策(划定边界) | 是 |
| 5 | 不在范围内 | 收集信息并指出反模式 | 否 |
| 6 | 成功标准 | 实际决策(衡量什么) | 是 |
| 7 | 边界情况 | 收集信息 | 否 |
| 8 | 假设与风险 | 收集信息 | 否 |
确认完 8 个部分后:
- 使用
assets/prd-template.md组装PRD.md——原样复制模板,不修改结构或标题。 - 用已确认的回答填充每个部分。如果仍有 Agent 未明确说明的假设,用 `` 标记。
- 写入磁盘上的
PRD.md(项目根目录),除非用户指定其他路径。 - 结束时提醒用户:PRD 是一份结构化草稿——实际审核(歧义、数字、边界)仍由人来完成。
质量检查
结束前,静默检查以下内容:
- 8 个部分均已包含,且没有空项——每项至少有一个要点/想法,即使内容很简略。
- “不在范围内”至少包含一项明确排除的内容(不能写成“以上未提及的所有内容”)。
- 成功标准可验证,不能只是没有衡量依据的形容词。
- Agent 的所有假设都已用 `` 标记。
- 如果在完成所有部分之前就结束,则在文件中用 `` 标记剩余部分。
参考资料
assets/prd-template.md——模板原文,不可修改。与generar-prd中的模板完全相同。references/secciones-guia.md——各部分的深入探讨指南:具体问题、带权衡的备选方案、反模式,以及好坏回答示例。
评论
支持 Markdown