业务交接：诊断维护与 PDF 交付

业务目标与触发

目标：把维护诊断和 artifact/PDF 交付拆成两个不会修改 ERP 的支撑业务。

触发：部署健康、route/API/form 探针、性能分析、客户映射诊断、source 文档转 PDF、PDF 校验、文件交付。诊断请求不应触发下单；PDF 请求不应触发重新保存。

Skill 标准化

诊断使用 skills/erp-diagnostics-maintenance，默认 maintainer-only、no-ERP、read-only；PDF 使用 skills/erp-pdf-delivery，接收已有 source artifact，不创建或更新 task。诊断需要 connected probe 时必须有显式维护者批准；PDF 转换失败保留源文件。

Task JSON

诊断通常不进入 ERP task runner，使用明确的 no-ERP command 和证据文件。PDF 业务不把 create/update 任务改写成 PDF 命令，必须记录已有 identifier/source artifact 和交付意图。若需要导出先走 erp-export-recovery，再转 PDF。

脚本与工具

诊断入口：

npm run health:no-erp
node tools/erp_deployment_health_check.js --config config/erp-deployment.example.json --no-erp

可选只读工具包括 erp_all_routes_api_probe.js、erp_team_single_api_probe.js、erp_inspect_team_batch_modify.js、erp_split_parent_inspect.js、erp_split_child_inspect.js、erp_performance_profile.js、erp_customer_resolver.js。PDF 入口是 tools/erp_pdf_conversion.js 和 approved convert_erp_docs_to_pdf.ps1。

结果

诊断输出 scope、tool、evidence、failure、next maintainer action；不证明 live save。PDF 输出 source_ready、pdf_completed、pdf_blocked 或 handoff_required；客户回复只说 artifact 类型和交付状态，不暴露内部路径。

阻塞与恢复

诊断默认 no-ERP；连接式探针无批准、需要验证码、需要保存样本或作用域不明时阻塞。PDF source 缺失或转换失败时保留 source、交人工处理，不重做 ERP save。

测试与证据

skills/erp-diagnostics-maintenance 和 skills/erp-pdf-delivery quick_validate/内容测试通过。
npm run health:no-erp：13/13。
tools/tests/erp_pdf_conversion.test.js：5/5。
诊断和 PDF 必须使用 fixture/source 文件，不触碰 live ERP 或客户输出目录。

风险

把诊断当成生产执行、探针误 submit、验证码绕过、源文件丢失、PDF失败被误报为ERP失败、内部路径泄露是主要风险。缓解：maintainer-only、no-ERP、显式批准、source-first、输出验证和脱敏回复。

负责人

诊断维护负责人管理 probes/health；交付负责人管理 PDF/source artifact；ERP 运行负责人批准连接式探针。交接日期：2026-07-12。

下一步

在真正 Git 仓库提交本轮文档；若要新增连接式探针或统一 visitor-detail/PDF handler，先补 operation 契约、fixture、read-only 测试和证据，再评估是否进入生产入口。

2.8 KiB Raw Permalink Blame History Unescape Escape