用途
PM Skill Auditor 是一个分发（Dispatch）技能，作为 pm-skill-auditor 子代理的跨客户端包装器。它用于对仓库执行全库范围的横切治理审计：运行全部强制校验器、执行跨领域检查，并重新推导聚合计数器，与 CONTEXT.md、AGENTS.md、README.md 中声明的数值进行比对。
主要能力
- 聚合强制校验器套件（优先使用 bash scripts/pre-tag-validate.sh 作为规范入口）。
- 执行跨领域检查，包括：无命令的技能（skill-without-command）、示例缺口（sample gaps）、家族契约孤儿（family contract orphans）等。
- 从文件系统重新推导聚合计数器，并与声明值比对。
- 按主计划 D26 输出分层报告：完整报告 + Status Summary + Status YAML。
- 支持作用域与严重级别参数，例如 --scope changed、--since-tag v2.15.0、--severity-floor P1。
使用方式
技能首先执行运行时检测，判断调用它的 AI 客户端：
- 在安装了 pm-skills 插件的 Claude Code 中：调用 @agent-pm-skills:pm-skill-auditor，传入 $ARGUMENTS 中的作用域参数，返回子代理的审计报告。
- 在其他 AI 客户端（Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI 等）：读取规范子代理定义 agents/pm-skill-auditor.md，将该文件中的系统提示正文作为本轮操作指令执行，运行四步审计流程：
- 步骤 1：通过 Bash 调用校验器（优先 bash scripts/pre-tag-validate.sh）。
- 步骤 2：运行跨领域检查目录中的检查项。
- 步骤 3：从文件系统重新推导聚合计数器并与声明值比对。
- 步骤 4：组合分层输出报告。 随后应用 $ARGUMENTS 中的作用域与严重级别参数，返回分层输出。
适用场景
- 需要全库审计：全部强制校验器、跨领域检查、聚合计数器重新推导。
- 在非 Claude AI 客户端上运行，且没有原生 pm-skill-auditor 子代理支持。
- 在 Claude Code 上，偏好技能调用语义（例如在工作流中与其他分发技能链式调用）。
不适用场景
- 想审查特定 PM 产物（PRD、OKR、persona）：改用 utility-pm-critic。
- 想起草 CHANGELOG 条目：改用 utility-pm-changelog-curator（Phase 4 发布）。
- 想发布版本：改用 utility-pm-release-conductor（Phase 5 发布）。
- 想修复审计发现的问题：审计器仅做检测，修复由维护者判断或未来的 pm-frontmatter-doctor（v2.17+）负责。
- 想对单个技能按编写约定做深度检查：改用 utility-pm-skill-validate；审计器是横向覆盖整个目录，不对单个技能深入。
跨客户端说明
截至 v2.16.0 的跨客户端状态：在 Claude Code + Codex CLI 上为 PRODUCTION（Codex CLI 已成功通过 Bash 调用校验器套件并生成带重新推导聚合计数器的分层审计报告）；在 Cursor / Windsurf / Copilot CLI / Gemini CLI 上为 EXPERIMENTAL。
“读取规范代理定义并内联执行”的模式依赖 AI 客户端具备三项能力：读取被引用的文件路径、执行 Bash 调用校验器脚本、将代理定义正文视为当前轮次的操作指令。多数 AI 客户端支持这三项；若某客户端上任何一项不可靠，该客户端回退为手动调用校验器 + 手动跨领域检查。
参考文件
- 规范子代理定义：agents/pm-skill-auditor.md
- 行为规范：docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md
- 运行时组件目录：docs/reference/runtime-components.md
- 跨领域检查目录：docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog
- 预标签校验器包：scripts/pre-tag-validate.{sh,ps1}
- 输出模板：references/TEMPLATE.md
- 完整示例：references/EXAMPLE.md
限制
该技能仅做检测，不执行修复。其跨客户端内联执行模式在部分客户端上仍为实验性，可能回退为手动流程。具体收费、价格、平台支持细节暂未提供。