如何用 BMAD-METHOD 的 bmad-prd 校验一份已有 PRD 并拿到 findings 报告

如何用 BMAD-METHOD 的 bmad-prd 校验一份已有 PRD 并拿到 findings 报告【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODPRD 已经写好了你不确定它的质量够不够支撑后续的 UX、架构和拆 story——但不想让它被顺手改写。BMAD-METHOD 的bmad-prd提供了三个意图create、update、validate其中Validate就是专门做这件事对已有 PRD 只批评、不修改Critiques without changing最后合成一份 findings 报告validation-report.htmlvalidation-report.md给你打开。Define Requirements and a Specification 对 Validate 的原文描述是critiques without changing and produces a findings report。这篇文章按实际操作顺序走一遍前置条件、如何触发校验、报告会落在哪里、报告怎么读、怎么复跑和继续处理 findings。前置条件项目里已安装 BMad。Choose a Planning Path 的前置说明明确要求使用任何 BMad 工作流之前先安装 BMad。有一份已落盘的 PRDprd.md如果存在配套addendum.md存放 PRD 正文之外、属于下游文档的深度内容校验时会被一并读取。环境里可用uv。bmad-prd的激活步骤要通过uv run {project-root}/_bmad/scripts/resolve_customization.py ...之类的命令解析定制配置见 bmad-prd 的 SKILL.md这些脚本依赖uv执行。交互语言来自项目配置{project-root}/_bmad/bmm/config.yaml若存在config.user.yaml则一并加载缺失的键走中性默认值不会阻塞运行。触发校验明确说 validateChoose a Planning Path 说得很直白bmad-prdhas three intents, create, update, and validate; say which one you want when you invoke it, or it will ask. 也就是说在新的会话里调用bmad-prd第一句话就说明你要validate已有的 PRD并把prd.md的路径或所在 run 目录告诉它如果你没说清意图skill 会停下来问你三者选哪个——不会猜。两点提醒老版本的独立 skillbmad-validate-prd已废弃现在只是一个转发壳它向前转发给bmad-prd并预置 validate 意图见 bmad-validate-prd shim。新工作直接调用bmad-prd。校验全程不改动PRD 正文Validate 结束后不会执行 Create/Update 流程里的 Finalize 阶段memlog 审计、polish、status 置 final 等都不做。交给它之后发生了什么流程定义在 references/validate.md分三步Orient对.memlog.md如果该 PRD 之前跑过 Create/Updatememlog 里有历史决策、你提供的原始输入、以及 PRD/addendum 本身做 source-extract由子代理抽取、父代理汇总。Reviewer Gate并行派发评审子代理每个把自己的完整评审写入 run 目录{doc_workspace}下的review-{slug}.md只向父代理返回紧凑摘要verdict、top 2–5 findings、文件路径。其中rubric walker 是默认评审入口。它逐条对照质量 rubric默认 assets/prd-validation-checklist.md走 PRD对七个维度各给出strong / adequate / thin / broken判断Decision-readiness、Substance over theater、Strategic coherence、Done-ness clarity、Scope honesty、Downstream usability、Shape fit。findings 只写在真正有信息量的地方要求引用 PRD 的具体位置并原话引用严重度critical/high/medium/low衡量的是对 PRD 实用性的影响而不是修复难度。结果写入{doc_workspace}/review-rubric.md。附加评审来自finalize_reviewers配置references/validate.md 注明默认含 adversarial-general条目支持skill:、file:前缀或纯文本提示词。Synthesis父代理读取所有review-*.md填入 HTML 骨架默认 assets/validation-report-template.html写出两份报告然后用平台默认方式打开 HTML——macOS 用openLinux 用xdg-openWindows 用start 路径加双引号open {doc_workspace}/validation-report.html打开失败时不会换别的 opener 重试而是直接告诉你文件路径继续往下走。headless 模式跳过打开这一步。{doc_workspace}是本次运行绑定的 run 目录headless 模式下对 Validate 意图工作区默认取 PRD 所在目录见 headless.md。报告文件就落在这个目录里。怎么读这份 findings 报告HTML 报告validation-report.html头部会给出 PRD 名称、路径和总体评级。评级是文档中定义的映射不是主观打分Excellent所有维度 strong/adequate且无 high/critical findingsGood至多 1 个 thin 维度且无 critical findingsFair多个 thin 维度或存在任意 high findingPoor任意 broken 维度或存在任意 critical finding。Markdown 孪生文件validation-report.md按严重度而不是维度分组是文档明确标注的canonical form for downstream re-reading后续复读建议看这份。它的结构固定为Overall verdict2–3 句综合判断、Dimension verdicts各维度结论、Findings by severityCritical/High/Medium/Low 四档每条 finding 带标题、§ 位置、Note 和建议 Fix、Mechanical notes术语漂移、ID 连续性、断链等轻量问题、Reviewer files本次产出的各review-*.md列表。交互模式下findings 不会一次性倾倒出来先给一句 gate verdict然后逐条过 critical 和 highmedium/low 收成一句plus N more in {file}收尾。对每条 finding 你可以选autofix、discuss、defer to open items 或 ignore。想看某条的完整上下文再读对应的review-{slug}.md。复跑校验与后续处理复跑重新跑一次 validate 会就地覆盖合并报告validation-report.html/.md各个review-*.md单独保留方便下钻。收尾validate 结束时 skill 会列出工件路径并且总会提供把 findings 滚进一次 Update 的选项。如果你要真正按 findings 修改 PRD下一步就是用 update 意图再跑一次bmad-prd——Update 会先把改动与 memlog 里既有决策的冲突摊出来再应用。可选分支headless非交互校验如果调用来自另一个 skill 或非交互 runner无 TTYbmad-prd按 headless 模式运行第一条消息里给出intent: validate和prd.md的路径或包含它的工作区路径可选附 checklist 覆盖路径工作区默认取 PRD 所在目录。差异有三点无论 findings 数量多少validation-report.html和validation-report.md都会写出跳过打开浏览器写完即返回以 JSON 状态收尾完整 schema 见 assets/headless-schemas.md{ status: complete, intent: validate, validation_report: {doc_workspace}/validation-report.md, findings_summary: { critical: 0, high: 0, medium: 0, low: 0 }, offer_to_update: true }上面的数值是文档给出的示例形态实际计数以本次运行为准。status的判定规则rubric/checklist 加载失败等产物生成了但留了缺口的情况是partialopen_questions[]非空时也是意图无法推断时blocked并带reason不会产生工件。可选分支换一套团队 rubric默认 rubric 是assets/prd-validation-checklist.md但bmad-prd的定制面允许覆盖。在团队级_bmad/custom/bmad-prd.toml或个人级_bmad/custom/bmad-prd.user.toml中把validation_checklist_template指向你自己的 rubric 文件即可字段说明见 customize.tomlHTML 骨架同样可用validation_report_template换成组织品牌版本。边界与限制Validate 只批评不修改也不跑 Finalizememlog 审计、输入对账、polish、frontmatter 置status: final都不属于这个意图那是 Create/Update 收口时的事。报告评级和 findings 是文档定义的判断 rubric 的产出severity 按对 PRD 有用性的影响排序不是按修复成本排序文档没有给出任何自动通过/失败的量化阈值别把评级当成门禁数字用。想让 findings 生效路径只有两条选 autofix/discuss 处理后通过 Update 意图回写 PRD或把 deferred 项记入 memlog 留待复看memlog.py append是 skill 内部机制一般由它自己执行。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考