workflow_report_writing_matrix
道-元路由 · 道层 skill 全文
本页是 <code>rules/skills/drafts/workflow_report_writing_matrix.md</code> 的逐字投影（仅隐私清洗，零改写）。
时点提示：本页是仓内文件 rules/skills/drafts/workflow_report_writing_matrix.md 的逐字投影（仅做隐私清洗：仓库根绝对路径→相对路径、家目录→~/；除此零改写）。若源文件后续有修订，以仓内真源为准。
报告写作矩阵（communications 矩阵）
元数据
- 类型：Workflow（路由 meta）
- 适用场景：写任何交付给用户的报告前，先按"报告类型 × 关注点"定位该叠加哪几个 skill
- 状态：Draft（2026-05-31）
- 怎么形成的：把语言（道）、内容组织（术）、格式渲染（术）三层拆开，各司其职，组合成一张可查的表
道层（横贯所有格，always-on）
COMMUNICATION.md：去 AI 味语言纪律（四类翻译腔、归化、思维英文 / 产出中文）。注入式常驻，所有报告自动受它管，不用在术层 skill 里重述。用户说的"去 AI 味"就是这一层。
矩阵
| 报告类型 ＼ 关注 | 内容组织（写什么、怎么核对） | 格式渲染（怎么呈现） |
|---|---|---|
| 实现 / 走查报告（记录已完成的工作） | bestpractice_report_readability：易读性 ＝ 完整记录变化（任务怎么做 / 改了什么 / 前后 / 问题）＋证据链＋look-back 真实记录＋图优先 | HTML：bestpractice_final_report（含走查结构 6 字段 / 测试 6 维 / 修改记录分图）｜ MD：bestpractice_markdown_report |
| 调研 / survey 报告（综合研究，播客感） | workflow_analytical_writing：去汇总感、判断框架、叙事重构、证据分层（已覆盖，不新建）；去 AI 味由 COMMUNICATION.md 提供 | MD 为主：bestpractice_markdown_report；要上线 share_report；要富交互 HTML 才用 bestpractice_final_report |
底层工具：bestpractice_markdown_html_conversion（MD→HTML 转换机制）、share_report（发布上线）。
landing-pipeline 任务报告约定
landing-pipeline 任务报告先用 report_scaffold 工具起草，统一存放在 adhoc_jobs/landing_requirement_decomposition_20260531/reports/。脚手架从 todo dispatch <T-id> 注入原始 prompt 和任务元数据，避免写作者凭记忆复述需求。
RPT-01 四点标准是在 bestpractice_report_readability 四件事（任务怎么做 / 改了什么 / 前后对比 / 遇到的问题）基础上的额外强制项：专业术语注释必须在术语出现处说明本系统特定定义与独特实现；原始 prompt 必须逐字记录，作为本管线的 provenance 锚；实现逻辑要解释为什么有效；变更对比优先用图或表呈现 before -> after。
这里和 bestpractice_report_readability 的降噪规则按报告类型分流。一般实现报告不要过度复述 Proposal / Project 原始要求；landing-pipeline 报告必须填原始 prompt 逐字原文，因为这类报告的核心诉求是需求可追溯。两条规则不互相覆盖：landing-pipeline 报告按本节执行，其他实现报告仍按 readability 的降噪规则执行。
可视化维度（变更报告）
报告记录架构 / 结构变更时，可视化是横贯内容与格式的第三维，单独路由：
- 选图与组织判断（该不该画、画结构对比还是流程对比、画前 look-back 取证、怎么组织成首屏看图）→ 道
workflow_change_visualization。 - before/after 模板、三色 classDef、节点边语义、降级兜底 → 术
bestpractice_markdown_report。 - 收口验有没有真 before/after 图 →
check_report_completeness的 RC5。
RPT-01 (d) 变更对比因此从「优先用图或表」收紧：结构 / 流向变更应有 before/after 图，纯指标用表、纯配置用 diff。
怎么用
两步定位。先认报告类型：在记录我做了什么 ＝ 第一行，在综合外部研究下判断 ＝ 第二行，拿对应的内容 skill。再认交付格式：HTML 或 MD，拿对应的格式 skill。道层自动在场，不用想。内容 skill 只管写什么和怎么核对，格式 skill 只管怎么呈现，两边不重叠。
为什么这样分（任务分离逻辑）
- 内容和格式分开：同一份内容判断（变化记录、证据链）要能复用到 HTML 和 MD，所以抽到内容 skill；HTML 和 MD 各自的渲染纪律抽到格式 skill。
- 实现报告和调研报告分开：前者是记录我做了什么变化，靠 look-back 真实过程记录核对；后者是综合外部研究下判断，靠去汇总和判断框架。两者内容组织逻辑不同，分两个内容 skill。
- 语言层独立常驻：去 AI 味对所有报告都生效，放道层注入，不在每个术层 skill 里重述。
- 不新建重复 skill：调研报告去 AI 内容本想单做一个，但
workflow_analytical_writing已经在做（去汇总 ＋ 判断框架），COMMUNICATION.md提供去翻译腔，重复建会违反"优先修改而非新建"，所以路由到现有两者。
<!-- created 2026-05-31 by zlx: 报告写作矩阵路由，道(COMMUNICATION)×内容(readability/analytical)×格式(final_report/markdown) -->