用途:审查 Maple 自身代码的 diff、PR 或指定文件是否符合 OpenTelemetry 规范,规范依据为 docs/otel-spec/ 中的快照(spec v1.58.0,研究日期 2026-07-05)。它不同于 maple-audit(整项目埋点质量审计)、maple-telemetry-conventions(内部约定参考)和通用 /code-review(diff 正确性)。交付物是规范发现:带规范性引用的 MUST/SHOULD 违规。
主要能力:按严重度分级——critical 违反 Stable 章节的 MUST/MUST NOT/SHALL/REQUIRED;warn 违反 SHOULD/SHOULD NOT 或新依赖已弃用路径;info 为 MAY/建议性偏离、Development/Experimental 章节内容或 README 已知缺口项(标记 unverified)。通过路由表把 diff 触及内容映射到最小规范章节,按标题文本而非行号路由,覆盖三个面:1 摄取网关作为 OTLP 服务器、2 自埋点作为 SDK 消费者、3 UI/查询作为数据消费者。
使用方式:先界定审查范围(git diff、PR、git show <sha> 或用户指定文件),按路径分组;再分类到面与路由行并展示给用户确认;然后最小化加载规范(先查快速表,必要时用 Grep -n '^##' 定位标题再按 offset/limit 读取,默认 ≤2 个规范文件,禁止整文件通读);逐 hunk 对照规范文本,记录 file:line 证据;先输出发现报告(含严重度、规范引用、发现、证据、Source 链接),用户要求时才按严重度修复,修复后运行 bun typecheck 或 cargo check 验证。
限制:每条发现必须引用 docs/otel-spec/ 文件与章节标题并复制其内联 Source 链接;语料未覆盖的问题报告为“not covered by the corpus — not reviewed”,不得凭模型记忆推断规范。README 已知缺口项上限为 info 并标记 unverified。Maple 已记录的有意偏离不算发现。报告前不得编辑,不得提交、推送或开 PR,不得扩展为整仓库审计。内部约定问题归入 House-convention notes,不得误标为规范违规。