utility-pm-skill-auditor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

PM Skill Auditor (Dispatch Skill)

Cross-client dispatch wrapper for the

pm-skill-auditor

sub-agent. Detects runtime; dispatches to the native sub-agent on Claude Code; reads

subagents/pm-skill-auditor.md

and executes inline on non-Claude clients.

pm-skill-auditor

子代理的跨客户端调度包装器。可检测运行环境；在Claude Code上调度至原生子代理；在非Claude客户端上读取

subagents/pm-skill-auditor.md

并内联执行。

When to Use

使用场景

You need a repo-wide audit pass: all enforcing validators, cross-cutting checks (skill-without-command, sample gaps, family contract orphans, etc.), and aggregate counter re-derivation against declared values in CONTEXT.md + AGENTS.md + README.md
You are running on a non-Claude AI client without native pm-skill-auditor sub-agent support
You are running on Claude Code and prefer skill-invocation semantics (e.g., for chaining inside a workflow that also uses other dispatch skills)

需要执行全仓库审计：所有强制执行的验证器、跨领域检查（无命令的skill、示例缺失、家族契约孤立项等），以及针对CONTEXT.md + AGENTS.md + README.md中声明值的聚合计数器重新推导
运行在不支持原生pm-skill-auditor子代理的非Claude AI客户端上
运行在Claude Code上，且偏好skill调用语义（例如，在同时使用其他调度skill的工作流中进行链式调用）

When NOT to Use

不适用场景

You want to review a specific PM artifact (PRD, OKR, persona) -> use
```
utility-pm-critic
```
instead
You want to draft a CHANGELOG entry -> use
```
utility-pm-changelog-curator
```
(ships in Phase 4)
You want to ship a release -> use
```
utility-pm-release-conductor
```
(ships in Phase 5)
You want to FIX issues found in an audit -> the auditor is detection-only; remediation is maintainer judgment or future
```
pm-frontmatter-doctor
```
(v2.17+)

想要评审特定PM工件（PRD、OKR、用户画像）-> 改用
```
utility-pm-critic
```
想要撰写CHANGELOG条目 -> 改用
```
utility-pm-changelog-curator
```
（将在第4阶段推出）
想要发布版本 -> 改用
```
utility-pm-release-conductor
```
（将在第5阶段推出）
想要修复审计中发现的问题 -> 该审计工具仅用于检测；修复需由维护者判断或使用未来版本的
```
pm-frontmatter-doctor
```
（v2.17+）

Instructions

操作说明

Runtime detection step. Determine which AI client is invoking this skill.

运行环境检测步骤。确定调用该skill的AI客户端类型。

If you are running in Claude Code with the pm-skills plugin installed

若在已安装pm-skills插件的Claude Code中运行

Invoke

@agent-pm-skill-auditor

on the repo. Pass any scope arguments from

$ARGUMENTS

(e.g.,

--scope changed

--since-tag v2.15.0

--severity-floor P1

). Return the sub-agent's audit report to the user.

在仓库上调用

@agent-pm-skill-auditor

。传递

$ARGUMENTS

中的所有范围参数（例如

--scope changed

、

--since-tag v2.15.0

、

--severity-floor P1

）。将子代理的审计报告返回给用户。

If you are running in any other AI client

若在其他任何AI客户端中运行

Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, or any other client without native pm-skills plugin sub-agent support:

Read the canonical sub-agent definition at
```
subagents/pm-skill-auditor.md
```
Execute the system prompt body in that file as your operating instructions for this turn
Run the four-step audit flow:
- Step 1: Invoke validators via Bash (prefer
```
bash scripts/pre-tag-validate.sh
```
  as canonical entry point)
- Step 2: Run cross-cutting checks from the catalog at
```
docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog
```
- Step 3: Re-derive aggregate counters from filesystem and compare to declared values
- Step 4: Compose layered output report
Apply scope and severity-floor arguments from
```
$ARGUMENTS
```
Return the layered output per master plan D26 (full report + Status Summary + Status YAML)

Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI，或任何其他不支持原生pm-skills插件子代理的客户端：

读取位于
```
subagents/pm-skill-auditor.md
```
的标准子代理定义
将该文件中的系统提示正文作为本次交互的操作指令执行
运行四步审计流程：
- 步骤1：通过Bash调用验证器（优先使用
```
bash scripts/pre-tag-validate.sh
```
  作为标准入口）
- 步骤2：执行位于
```
docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog
```
  目录中的跨领域检查
- 步骤3：从文件系统重新推导聚合计数器并与声明值对比
- 步骤4：生成分层输出报告
应用
```
$ARGUMENTS
```
中的范围和最低严重程度参数
按照主计划D26返回分层输出内容（完整报告 + 状态总结 + Status YAML）

Cross-Client Notes

跨客户端说明

See Sub-Agent Compatibility Matrix for the canonical cross-client status. Summary for this skill as of v2.16.0: PRODUCTION on Claude Code + Codex CLI (Codex CLI successfully invoked the validator suite via Bash + produced a layered audit report with re-derived aggregate counters); EXPERIMENTAL on Cursor / Windsurf / Copilot CLI / Gemini CLI.

The "read canonical agent definition and execute inline" pattern depends on the AI client being able to:

Read a referenced file path
Execute Bash to invoke validator scripts
Treat the agent definition body as operating instructions for the current turn

Most AI clients support all three. If any are unreliable on a specific client, that client falls back to manual validator invocation + manual cross-cutting checks.

查看子代理兼容性矩阵获取标准跨客户端状态。截至v2.16.0，本skill的状态总结：在Claude Code + Codex CLI上为生产环境可用（Codex CLI可通过Bash成功调用验证器套件，并生成包含重新推导聚合计数器的分层审计报告）；在Cursor / Windsurf / Copilot CLI / Gemini CLI上为实验性可用。

“读取标准代理定义并内联执行”模式依赖AI客户端具备以下能力：

读取指定文件路径
执行Bash以调用验证器脚本
将代理定义正文作为当前交互的操作指令

大多数AI客户端都支持以上三项能力。若某特定客户端在任意一项上不可靠，则该客户端需退化为手动调用验证器 + 手动执行跨领域检查。

Reference Files

参考文件

Canonical sub-agent definition:
```
subagents/pm-skill-auditor.md
```

Behavioral spec:

docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md

Runtime components catalog:
```
docs/reference/runtime-components.md
```

Cross-cutting check catalog:

docs/internal/release-plans/v2.16.0/spec_pm-skill-auditor.md#cross-cutting-check-catalog

Pre-tag validator bundle:
```
scripts/pre-tag-validate.{sh,ps1}
```
Output template:
```
references/TEMPLATE.md
```
Worked example:
```
references/EXAMPLE.md
```

标准子代理定义：
```
subagents/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
```