From prd-distill
将 PRD、需求文本、技术方案或变更说明先做稳定读取与质量检查,再蒸馏为有证据支撑的 report、plan、spec 和 context,包括 Requirement IR、Layer Impact、Contract Delta、技术方案、开发/测试/契约计划和 reference 回流建议。适用于用户调用 /prd-distill,要求分析 PRD、拆需求、评估影响范围、生成开发计划、识别接口契约风险或生成 QA 矩阵时。
npx claudepluginhub zachary-lz-glm/prd-tools --plugin prd-distillThis skill uses the workspace's default tool permissions.
Claude Code 中通过 `/prd-distill <PRD 文件或需求文本>` 触发。
agents/openai.yamlreferences/external-practices.mdreferences/layer-adapters.mdreferences/output-contracts.mdreferences/portal-design-system.mdreferences/schemas/00-directory-structure.mdreferences/schemas/01-ingest.mdreferences/schemas/02-capability-inventory.mdreferences/schemas/03-context.mdreferences/schemas/04-report-plan.mdreferences/schemas/05-readiness.mdreferences/selectable-reward-golden-sample.mdsteps/step-01-parse.mdsteps/step-02-classify.mdsteps/step-03-confirm.mdsteps/step-04-portal.mdworkflow.mdGuides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.
Processes PDFs: extracts text/tables/images, merges/splits/rotates pages, adds watermarks, creates/fills forms, encrypts/decrypts, OCRs scans. Activates on PDF mentions or output requests.
Share bugs, ideas, or general feedback.
Claude Code 中通过 /prd-distill <PRD 文件或需求文本> 触发。
人类可读文档见插件根目录 README.md。
/prd-distill 命令。不触发:直接改代码、无可分析输入、用户明确不要分析。
不是总结 PRD,而是回答五个问题:
_prd-tools/reference/。.md/.txt/.docx 或粘贴文本。_prd-tools/reference/。PRD 读取规则:
.md/.txt(直接读取)和 .docx(用 unzip 提取文本+图片,零第三方依赖)。.docx 读取:解压提取 word/document.xml,去除 XML 标签得到纯文本;同时提取 media/ 下的所有图片到 _ingest/media/。在文本中图片位置插入  占位。Claude 用 Read 工具直接查看图片(原生多模态),理解 UI 截图、流程图、数据图表。_prd-tools/distill/<slug>/
├── _ingest/ # PRD 原始读取
│ ├── source-manifest.yaml # 文件路径、格式、hash、读取方式
│ ├── document.md # 转换后可读 markdown
│ ├── document-structure.json # 段落、表格、图片结构块
│ ├── evidence-map.yaml # PRD 块级证据 id
│ ├── media/ # 抽出的图片
│ ├── media-analysis.yaml # 图片语义分析状态
│ ├── tables/ # 抽出的表格
│ ├── extraction-quality.yaml # pass/warn/block 质量门禁
│ └── conversion-warnings.md # 转换风险
├── report.md # 渐进式披露报告
├── plan.md # 函数级技术方案 + 开发/测试计划 + QA 矩阵
├── portal.html # 可视化浏览器页面(零外部依赖,双击即可打开)
└── context/
├── requirement-ir.yaml # 结构化需求:业务意图、规则、验收条件
├── evidence.yaml # 证据台账:PRD、技术方案、源码、负向搜索
├── readiness-report.yaml # 就绪度评分 + 风险 + provider 增益
├── graph-context.md # 源码扫描的函数级上下文
├── layer-impact.yaml # 分层影响
├── contract-delta.yaml # 契约差异
├── reference-update-suggestions.yaml # 回流建议
├── query-plan.yaml # 查询计划(辅助层)
├── context-pack.md # 上下文包(辅助层)
└── final-quality-gate.yaml # 最终质量门禁(辅助层)
| 文件 | 用途 | 不放 |
|---|---|---|
_ingest/* | PRD 原始读取结果 | 不写业务结论 |
report.md | 渐进式披露:摘要→变更→字段→规则→Checklist→契约风险→§11 阻塞项 | 不展开 YAML 证据链 |
plan.md | 技术方案 + 实现计划 + QA 矩阵 + 回滚方案 | 不复制 PRD 原文 |
context/evidence.yaml | 证据台账:PRD、技术方案、源码、负向搜索 | 不下结论 |
context/requirement-ir.yaml | 结构化需求:业务意图、规则、验收条件、变更类型 | 不写实现细节 |
context/readiness-report.yaml | 机器可读就绪度评分、风险、provider 增益 | 不替代 report.md 的人读解释 |
context/graph-context.md | 函数级技术上下文:源码扫描发现的符号、调用链和业务约束 | 不替代源码确认 |
context/layer-impact.yaml | 分层影响:目标层、能力面、计划变化、风险 | 不写字段级契约详情 |
context/contract-delta.yaml | 契约差异:字段、producer、consumer、alignment_status | 不写开发顺序 |
context/reference-update-suggestions.yaml | 回流建议 | 不直接改 _prd-tools/reference/ |
context/query-plan.yaml | 查询计划:种子锚点、影响提示、P0 术语(辅助层) | 不替代 graph-context.md |
context/context-pack.md | 上下文包:模型可消费的精简代码上下文(辅助层) | 不替代 graph-context.md |
context/final-quality-gate.yaml | 最终质量门禁:5 项确定性检查评分(辅助层) | 不替代 readiness-report.yaml |
portal.html | 自包含可视化页面:总览、源码命中、影响、契约、计划、QA、阻塞问题、回流建议 | 不替代 report.md 和 plan.md 的人读文本 |
读取 references/layer-adapters.md 按目标层套用适配器。路径只是候选,最终以能力面证据为准。
以下场景必须检查或生成 Contract Delta:
alignment_status 规则:
aligned:producer 和 consumer 都有证据。needs_confirmation:PRD 有描述但某层未确认。blocked:字段/枚举/required/时序冲突。not_applicable:单层内部变化。_ingest/evidence-map.yaml)。extraction-quality.yaml 为 warn 时必须在 report.md §11 暴露。report.md §11。confidence: low,不补脑。_prd-tools/reference/,只生成回流建议。report.md 生成前必须核对 P0/P1 细节:券批次/券张数/互斥、折扣卡 Card ID/数量/有效期/城市校验、EventRule、Budget/GMV、Push 占位符、PRD 内部冲突或 typo。不能只在 context YAML 中出现。extraction-quality.yaml 为 status: block。_prd-tools/reference/ 不存在:layer-impact/contract-delta confidence 强制降为 low,report.md §11 暴露缺失,readiness-report next_actions 首位建议运行 /reference。.md/.txt:直接读取。.docx:用 unzip 提取 word/document.xml(文本)和 media/(图片)。文本去 XML 标签后写入 _ingest/document.md,图片拷贝到 _ingest/media/。在文本中图片位置插入  占位。用 Read 工具逐个查看图片,理解内容后写入 _ingest/media-analysis.yaml。_ingest/ 证据结构。_prd-tools/reference/(优先 v4,兼容 v3.1),必须消费以下内容:
04-routing-playbooks.yaml:提取 PRD 关键词→target_surfaces 路由表,供步骤 7 源码扫描优先使用。01-codebase.yaml:提取 modules、registries、data_flows,作为源码扫描的代码地图。02-coding-rules.yaml:提取 fatal 级规则,在 layer-impact 中必须检查是否触及。03-contracts.yaml:提取现有契约,作为 contract-delta 基线。05-domain.yaml:提取领域术语,用于 requirement-ir 拆解时的术语对齐。EV-REF-CONSUMED)。low,report.md §11 必须暴露。context/evidence.yaml,映射 ingestion 证据后补充源码证据和 reference 消费证据。context/requirement-ir.yaml。_prd-tools/reference/index/ 存在,必须运行 python3 .prd-tools/scripts/context-pack.py 生成 context/query-plan.yaml(查询计划)。步骤 7 源码扫描必须消费 query-plan.yaml 的 matched_entities,不能跳过。context/graph-context.md。
04-routing-playbooks.yaml 路由表确定 target_surfaces,再查 01-codebase.yaml 获得精确文件路径和符号。禁止跳过直接 grep。reference_routing | index_query | code_scan。context/graph-context.md 必须存在。如不存在,必须先生成再继续 plan.md。reference_underconsumed。python3 .prd-tools/scripts/context-pack.py 生成 context/context-pack.md(上下文包)。index 不存在则跳过,但必须在 readiness-report 记录缺失。plan.md(消费 graph-context.md 函数级上下文)。context/layer-impact.yaml。context/contract-delta.yaml。report.md(渐进式披露 + 源码扫描命中摘要 + §11)。python3 .prd-tools/scripts/final-quality-gate.py 生成 context/final-quality-gate.yaml(5 项确定性检查评分)。context/reference-update-suggestions.yaml。context/readiness-report.yaml。portal.html(自包含可视化页面,详见 steps/step-04-portal.md)。| 文件 | 何时读取 |
|---|---|
workflow.md | 执行完整蒸馏时 |
steps/step-04-portal.md | 生成 portal.html 可视化页面时 |
references/output-contracts.md | 确认输出格式和字段边界时 |
references/layer-adapters.md | 判断能力面时 |
references/selectable-reward-golden-sample.md | 复杂需求校准时 |
references/external-practices.md | 解释设计依据时 |
完成后必须说明:
report.md 最重要结论。report.md §11 最重要阻塞项。needs_confirmation 或 blocked 契约。readiness-report.yaml 的 status、score、decision。portal.html 已生成,可在浏览器中打开查看完整可视化报告。