
1. 项目概述当AI成为你的产品副驾如果你是一名产品经理或者任何需要将想法落地为清晰、可执行文档的角色你一定经历过这样的时刻面对一个模糊的创意大脑一片空白不知从何写起或者花了几天时间呕心沥血写出一份PRD发给团队评审时却被各种“这里逻辑不通”、“那个场景没考虑”的反馈打回陷入反复修改的泥潭。传统的PRD撰写过程本质上是一场孤独的、高强度的、且极易陷入自我认知偏差的脑力劳动。今天要聊的这个项目prd-craft正是为了解决这个痛点而生。它不是一个简单的模板而是一套由AI驱动的、具备“双角色对弈”机制的PRD生成与审查工作流。你可以把它理解为你专属的、不知疲倦的“产品副驾”和“魔鬼评审官”的结合体。它的核心价值在于通过结构化的流程和量化的标准将你脑中模糊的想法一步步“盘问”清晰再通过严格的交叉审查打磨成一份高质量、逻辑自洽、团队能快速对齐的需求文档。我花了些时间深入研究了这个开源项目它本质上是一个精心设计的Prompt工程集合可以无缝集成到WorkBuddy这类AI助手环境中也能在普通的聊天界面中使用。最让我印象深刻的是它的“双角色对弈”设计——一个角色扮演“产品经理PM”负责创作另一个扮演“用户视角审查官”负责挑刺两者在隔离的上下文中循环工作模拟了真实产品团队中最有效的“创作-评审”博弈过程。接下来我将为你彻底拆解这套工作流的每一个环节分享如何将它应用到你的实际工作中以及我在测试中踩过的坑和总结出的高效技巧。2. 核心设计思路为什么“左右互搏”比单打独斗更有效在深入实操之前我们必须先理解prd-craft设计哲学背后的“为什么”。很多AI辅助工具只是简单地将提示词模板化让AI生成一份看似结构完整的文档。但prd-craft的野心更大它要解决的是需求定义过程中的系统性偏差问题。2.1 对抗性审查打破AI的“自我认同”陷阱当你让同一个AI模型既写PRD又审PRD时一个致命的问题是“自我认同偏差”。AI基于你给的初始提示和它自己刚生成的内容进行评审很容易陷入逻辑自洽的循环难以发现深层的矛盾或缺失。这就好比一个人自己给自己写的文章做校对很难发现那些“脑补”出来的、但并未明确写出的逻辑。prd-craft的解决方案是严格的角色与上下文隔离。在它的工作流中“PM”和“审查官”是两个完全独立的“智能体”审查官在评审时只能看到PRD文档的最终文本完全看不到PM在撰写过程中的任何思考、脑暴对话或之前的评审记录。这强制审查官必须基于文档本身做出独立、客观的判断。PM在收到评审意见后也只能看到结构化的问题清单和评分看不到审查官具体的推理过程。这种隔离模拟了真实职场中评审者拿到一份陌生文档进行评审的场景确保了审查的客观性和严厉性。审查官的角色指令中明确要求“禁止认同偏差”、“禁止降低标准”、“每轮至少指出3个可优化点”这相当于给AI套上了“找茬KPI”。2.2 六维度量化评分从“感觉不行”到“哪里不行差多少”传统的PRD评审反馈往往是感性的“这里写得不清楚”、“那个功能好像没必要”。这种反馈难以指导具体的改进。prd-craft引入了六维度加权评分卡将PRD质量这个模糊概念拆解为可度量、可比较的六个方面需求完整性 (25%)核心需求、用户场景、功能列表是否覆盖全面有没有遗漏关键业务流程逻辑自洽性 (20%)功能与目标之间、功能与功能之间是否存在矛盾或断层用户路径是否顺畅用户价值 (20%)是否清晰定义了解决了谁的什么痛点价值主张是否明确且有力可执行性 (15%)需求描述是否足够具体能让设计师、工程师理解并实现是否考虑了技术约束市场洞察 (10%)是否分析了竞品和市场需求差异化策略是否合理文档质量 (10%)结构是否清晰表述是否无歧义格式是否规范每个维度都有更细化的评分标准。例如“需求完整性”下会考察“目标用户画像是否清晰”、“核心用户旅程是否完整”。最终给出一个综合分数满分100和分项分数。这带来的最大好处是迭代可视化。第一轮得分65经过修改后第二轮得分78你不仅能知道文档变好了还能精确地知道是在“逻辑自洽性”和“可执行性”上有了提升。这种反馈比“感觉好多了”要有价值得多。2.3 P0/P1/P2问题分级建立清晰的修复优先级光有分数还不够还需要明确的行动指南。prd-craft将审查发现的问题分为三级P0 (阻塞性问题)通常是逻辑硬伤、核心需求缺失、严重的技术不可行性。这类问题不解决文档无法进入下一阶段。例如“支付流程中缺少风控环节存在资金安全风险。”P1 (重要问题)影响用户体验或实现效率的关键缺陷需要优先解决。例如“搜索功能未考虑模糊匹配和错别字容错会降低用户找到内容的概率。”P2 (优化问题)锦上添花的建议不影响主体功能可以在后续迭代中考虑。例如“欢迎页面的动画效果可以更丰富以提升第一印象。”这个分级机制让PM无论是真人还是AI扮演的PM能够快速抓住重点优先解决P0问题规划P1问题记录P2问题。它本质上是一个高效的注意力分配系统避免了在细节上过度纠结而忽略了主干问题。3. 工作流全解析从“一句话想法”到“高质量PRD”的六步法理解了核心思想我们来看prd-craft是如何一步步运转的。它的工作流被设计为一个六阶段的流水线每个阶段都有明确的输入、动作和产出。3.1 Phase 1 2: 需求接收与环境适配这个阶段是准备期。你只需要向AI集成了prd-craft技能的WorkBuddy或直接使用其Prompt输入你最初的想法哪怕它非常模糊。比如“我想做一个帮程序员管理碎片化知识链接的工具。”系统会首先理解你的意图然后自动检测运行环境。这里有个关键细节它支持两种模式。WorkBuddy原生模式推荐如果你在WorkBuddy中使用它能利用更丰富的交互能力比如自动将生成的PRD写入项目文件、提供更直观的选择器等体验更流畅。纯文本对话模式在任何支持Markdown的AI聊天界面如ChatGPT Web版、Claude等都能使用只是所有交互如文件输出都需要通过复制粘贴文本来完成。实操心得即使没有WorkBuddy我也强烈建议在支持长上下文和文件上传的模型如Claude 3.5 Sonnet中使用纯文本模式。你可以手动创建v1-prd.md这样的文件来模拟流程虽然麻烦点但核心的“双角色审查”价值丝毫不打折扣。3.2 Phase 3: 结构化脑暴——把模糊想法“问”清楚这是将想法转化为结构化需求的关键第一步。很多人在此卡住因为不知道问什么。prd-craft内置了一个“结构化脑暴框架”PM角色会根据你项目的类型ToC消费级、ToB企业级、效率工具、AI产品等自动发起3-5轮追问。例如针对“程序员知识链接管理工具”PM可能会问核心用户你面向的是所有程序员还是特定领域如前端、算法他们的技术栈和知识获取习惯有何不同核心痛点当前他们是如何管理这些链接的浏览器书签、笔记软件、收藏夹最大的不便是什么是容易遗忘、难以分类、无法关联代码片段还是无法快速检索核心功能设想你设想的核心功能是“保存链接并自动抓取摘要”、“打标签分类”、“与本地代码仓库关联”还是有“智能推荐相关链接”差异化与现有的Pocket、Raindrop.io或笔记软件的网页剪辑功能相比你的工具独特价值在哪里是因为更懂程序员的技术语境吗这个过程不是一次性的而是多轮对话。AI会根据你的回答不断深挖直到勾勒出一个相对清晰的需求轮廓。最终产出是一份需求摘要它将成为后续撰写PRD的蓝图。避坑指南在这个阶段你的回答越具体、越真实最终PRD质量越高。不要给AI模糊或理想化的答案。例如与其说“用户体验要好”不如说“我希望用户保存一个链接的操作步骤不超过3步且能通过命令行一键完成”。你的输入质量直接决定了AI输出的上限。3.3 Phase 4: 市场调研与PRD v1撰写有了清晰的需求摘要工作流进入构建阶段。这个阶段分为并行的两步Phase 4A: 市场调研集成PM角色会基于需求摘要自动进行“竞品分析”。它会模拟搜索和思考找出潜在竞品可能是真实存在的也可能是AI基于知识推断的并分析它们的优势、劣势以及你的产品可能的机会点。这些洞察会被直接融入到后续的PRD中通常在“市场与竞品分析”或“差异化策略”章节体现。这保证了你的PRD不是闭门造车而是带有市场视角。Phase 4B: 基于模板撰写PRD v1这是第一次正式输出。PM角色会调用一个标准的10章节PRD模板来撰写初版文档。这个模板非常全面覆盖了从项目概述、用户画像、用户故事、功能需求、非功能需求到发布计划、成功指标、附录等所有环节。每一节都有填写指引确保内容的完整性。至此你得到了一份结构完整、初具雏形的v1-prd.md。但请注意这只是起点质量通常参差不齐这也是引入审查循环的原因。3.4 Phase 5: 双视角循环审查——核心打磨环节这是prd-craft的灵魂所在也是最体现其价值的部分。Phase 5是一个最多进行5轮的循环审查过程流程如下审查官登场系统将v1-prd.md的纯文本内容不含任何之前的对话历史交给“审查官”角色。评审与输出审查官严格依据六维度评分标准和P0/P1/P2问题分级规则对PRD进行评审。产出两份关键文件v1-review.md包含详细的六维度评分卡、每个维度的扣分说明、以及一份结构化的P0/P1/P2问题清单。可选v1-prd-reviewed.md有些配置下审查官会直接在原PRD文件上用批注形式指出问题。决策点系统检查通过条件提前通过如果P0问题数为0且综合评分≥85分且剩余问题主要是P2级别的UX/UI优化建议则审查提前结束进入最终阶段Phase 6。继续迭代如果未达到提前通过标准且当前轮次小于5则将评审报告交给PM角色。PM修订PM角色收到评审报告必须逐条回应P0和P1问题。对于每个问题PM需要做出决策接受并修改PRD、拒绝并说明理由、或将其降级为P2需给出合理解释。然后PM基于这些决策生成修订后的v2-prd.md。循环将v2-prd.md再次交给审查官开始第二轮评审生成v2-review.md……如此循环直至达到通过条件或满5轮。5轮上限后的裁决如果5轮后评分≥75且无P0问题系统会判定为“达标”生成最终版但会附上未解决的P1问题提醒。如果5轮后评分75或仍有P0问题系统会输出所有遗留问题交由你真实用户来做最终决策是接受当前版本还是需要你亲自介入深度修改。这个循环过程相当于让AI进行了一场多轮的“自我博弈”每一轮都在试图攻克上一轮发现的弱点从而持续提升文档质量。3.5 Phase 6: 最终版输出与总结当审查循环结束后无论是提前通过还是满轮次达标系统会汇总整个审查历程生成最终版的final-prd.md和一份review-summary.md。总结报告会清晰展示从v1到final的评分变化曲线、各轮主要问题的解决情况让你对整个打磨过程一目了然。4. 实战部署与应用技巧了解了理论和工作流我们来谈谈怎么用它。prd-craft提供了两种使用方式各有优劣。4.1 方式一作为WorkBuddy Skill安装最佳体验这是最流畅的方式。WorkBuddy是一个AI智能体开发框架/平台prd-craft被封装为一个“技能”。克隆仓库git clone https://github.com/jiekingwu/awesome-prd-craft-skill.git安装技能将克隆的目录复制到WorkBuddy的skills目录下。你可以选择安装在用户目录所有项目可用或当前项目目录。调用在WorkBuddy对话中直接输入类似“使用prd-craft技能帮我写一个社区团购小程序的PRD”的指令即可。优势自动化程度高文件自动读写阶段转换无缝体验接近一个真正的AI协作产品。劣势需要你先搭建或拥有WorkBuddy环境。4.2 方式二直接使用Prompt最灵活通用如果你没有WorkBuddy完全没关系。项目根目录下的SKILL.md文件就是这个技能所有逻辑的“源代码”——一个超长的、结构化的系统提示词。打开SKILL.md复制全部内容。打开你常用的AI对话界面如ChatGPT、Claude、DeepSeek等。在需要的时候将整个SKILL.md的内容作为系统提示词或放在一条很长的用户消息开头发送给AI。然后告诉AI你的需求比如“现在请开始Phase 1我的想法是做一个个人财务记账App重点在可视化分析和预算预警。”优势零门槛在任何地方都能用。劣势你需要手动管理“上下文”。在角色切换时如从PM切换到审查官你需要手动将最新的PRD文本复制出来并在一个新的对话或明确清除上下文后连同审查官的角色提示词一起发送以模拟“上下文隔离”。同样PM修订时也需要手动传递评审报告。这个过程略显繁琐但能让你更深刻地理解其工作流。核心技巧如何手动模拟“上下文隔离”这是纯Prompt模式下的关键。假设你刚用PM角色生成了v1-prd.md。开启新会话最好在新标签页或新聊天中操作确保上下文干净。组合提示词将references/review-prompt-user.md审查官指令的内容作为系统提示词然后把v1-prd.md的全文作为用户输入发送给AI。这样AI就只基于PRD文本进行评审实现了隔离。切换回PM再开一个会话将references/review-prompt-pm.mdPM修订指令作为系统提示词然后把v1-review.md和v1-prd.md一起作为用户输入让AI进行修订。 虽然麻烦但这是保证审查客观性的唯一方法。4.3 高级配置单模型 vs. 双模型在prd-craft的设计中还有一个有趣的配置点你可以选择用同一个大语言模型来扮演PM和审查官也可以为两个角色分配不同的模型。单模型方便成本低。利用同一模型的不同“人格侧写”通过Prompt塑造进行对抗。效果取决于模型的角色扮演和逻辑一致性能力。双模型理论上能产生更激烈的“思维碰撞”。例如可以用一个创造性强的模型如GPT-4扮演PM用一个批判性思维强的模型如Claude 3扮演审查官。这能更好地模拟真实团队中不同思维风格成员的碰撞。在WorkBuddy中这可以通过配置实现。在纯Prompt模式中你需要手动将不同阶段的对话发给不同的模型实例。5. 常见问题、局限性与应对策略没有任何工具是银弹prd-craft在实战中也会遇到一些挑战。以下是我在多次使用后总结出的常见问题和应对方法。5.1 问题一AI的“幻觉”与事实性错误尤其在“市场调研”阶段AI可能会生成一些不存在的“竞品”或错误描述其功能。虽然这有时能提供启发但也可能误导方向。应对策略将AI的竞品分析视为调研线索而非结论。你需要亲自去验证AI提到的关键竞品信息。在PRD中可以注明“根据初步AI分析潜在竞品可能包括A、B其特点为……需进一步实地验证”。5.2 问题二对复杂业务逻辑的理解深度有限对于涉及复杂业务规则、特定行业知识如金融合规、医疗流程的需求AI可能无法理解其深层逻辑和约束导致生成的PRD流于表面。应对策略你在Phase 3脑暴阶段的输入至关重要。你需要充当领域专家在回答AI追问时就将复杂的业务规则、专业术语、合规要求清晰地灌输给它。把AI当成一个聪明但不懂行的实习生你需要耐心地把背景知识“教”给它。5.3 问题三审查循环陷入局部优化有时PM和审查官会在一些文案细节、措辞上反复纠缠进行了多轮修改但评分提升缓慢感觉陷入了“局部最优”。应对策略人工介入打破循环。作为使用者你需要在几轮后主动审视review-summary.md。如果发现评分卡在某个区间且问题清单开始重复或变得琐碎就应该手动停止循环。审查报告本身已经为你指明了核心问题你可以基于此亲自进行大刀阔斧的修改而不是完全依赖AI的微调。5.4 问题四输出格式的稳定性在纯Prompt模式下不同模型、甚至同一模型的不同会话输出Markdown的格式如标题层级、代码块标注可能略有差异给后续整理带来小麻烦。应对策略在Prompt中强化格式指令。你可以在使用SKILL.md时在最前面加上一句“请严格遵守给定的Markdown格式规范所有输出必须符合GFM标准确保标题层级、列表、代码块等格式一致且规范。”这能在一定程度上提高稳定性。5.5 问题五对“创新”的抑制严格的模板和审查机制有时可能会让输出显得“标准”但“平庸”压制了一些跳出框架的创新性想法。应对策略将prd-craft视为“基础构建器”和“质量检验员”而非“创意源泉”。它的强项在于将清晰的创意结构化、逻辑化、无歧义化。真正的创新火花应该来自于你自身。你可以先用它生成一个扎实的基准版PRD然后再在此基础上人工注入那些突破性的、冒险的创意点并评估这些点对原有结构的影响。6. 超越工具将PRD-Craft思维融入日常工作最后我想分享的不仅是工具的使用更是其背后思维模式的启发。即使你不直接使用这个技能它的方法论也极具价值。1. 将“写作”变为“对话与审查”流程不要一个人闷头写文档。试着模拟这个流程先自己和自己或和同事进行一轮结构化脑暴问清楚5W2H写个初稿然后换一个身份或者请同事扮演“魔鬼审查官”用一份简单的检查清单可以借鉴六维度来批判它根据反馈修订甚至进行多轮。这能极大提升文档质量。2. 建立量化的评审标准在你的团队中尝试为PRD或设计稿引入简单的评分机制。不需要六个维度那么复杂可以从“清晰性”、“完整性”、“可执行性”三个维度开始让大家在评审时打分并给出简短理由。这能让反馈更具体减少模糊争吵。3. 明确问题优先级在团队协作中强制要求对提出的问题或Bug进行P0/P1/P2分级。这能帮助大家快速对齐什么是必须立刻解决的什么是可以稍后优化的什么是锦上添花的从而提升会议和协作效率。prd-craft这个项目与其说是一个AI技能不如说是一套关于如何严谨地定义需求的方法论的数字封装。它通过AI的力量将这套方法论变得可执行、可重复、可度量。对于产品经理、创业者、甚至任何需要清晰表达复杂想法的人来说它都是一个值得深入研究和融入工作流的强大辅助。工具永远在进化但背后那种追求清晰、逻辑、可执行的思考方式才是真正值得我们带走的东西。