mcpField
U
utility-pm-skill-auditor

utility-pm-skill-auditor

github.com/product-on-purpose测试与质量769606 次安装4 天前更新
代码仓库

关于 utility-pm-skill-auditor

面向 pm-skills 仓库的跨客户端审计调度技能，用于执行全仓验证和交叉检查。Claude Code 中调用原生子 Agent，其他客户端则读取其定义并在当前环境执行；审计只发现问题，不负责修复。

主要功能

  1. 01检测运行客户端并选择执行方式
  2. 02运行验证器与跨目录检查
  3. 03重新核算并核对汇总计数
  4. 04按层级生成审计报告
  5. 05仅检测问题，不执行修复

适用场景

  1. 01发布前审查整个技能目录
  2. 02在不支持原生子 Agent 的客户端执行审计
  3. 03核验 CONTEXT.md、AGENTS.md 与 README.md 中的计数
  4. 04按范围或严重级别筛选审计

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-skill-auditor

安装后在 Claude Code 中输入/utility-pm-skill-auditor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

HISTORY.md
evals/
trigger-fixtures.json
references/
EXAMPLE.md
TEMPLATE.md

详细介绍

PM 技能审计器（分发技能）

pm-skill-auditor 子 Agent 的跨客户端分发包装器。检测运行环境；在 Claude Code 上分发给原生子 Agent；在非 Claude 客户端上读取 agents/pm-skill-auditor.md 并以内联方式执行。

适用场景

  • 你需要进行全仓库审计：检查所有强制验证器、跨领域检查（缺少命令的技能、示例缺口、系列契约孤项等），并根据 CONTEXT.md + AGENTS.md + README.md 中声明的值重新推导汇总计数
  • 你正在使用不支持原生 pm-skill-auditor 子 Agent 的非 Claude AI 客户端
  • 你正在使用 Claude Code，并倾向于采用技能调用语义（例如，在同时使用其他分发技能的工作流中进行串联）

不适用场景

  • 你想审查特定的 PM 产物（PRD、OKR、用户画像）-> 改用 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。审计器会广泛检查整个目录，而不会深入检查单个技能。

说明

运行环境检测步骤。 确定调用此技能的 AI 客户端。

如果你在已安装 pm-skills 插件的 Claude Code 中运行

对仓库调用 @agent-pm-skills:pm-skill-auditor。传入 $ARGUMENTS 中的任何范围参数（例如 --scope changed、--since-tag v2.15.0、--severity-floor P1）。向用户返回子 Agent 的审计报告。

如果你在任何其他 AI 客户端中运行

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

  1. 读取规范子 Agent 定义 agents/pm-skill-auditor.md
  2. 将该文件中的系统提示词正文作为本轮操作指令执行
  3. 执行四步审计流程：
    • 第 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 步：编写分层输出报告
  4. 应用 $ARGUMENTS 中的范围和严重性下限参数
  5. 按主计划 D26 返回分层输出（完整报告 + 状态摘要 + 状态 YAML）

跨客户端说明

规范的跨客户端状态请参阅子 Agent 兼容性矩阵。截至 v2.16.0，此技能的摘要状态：在 Claude Code + Codex CLI 上为 PRODUCTION（Codex CLI 已成功通过 Bash 调用验证器套件，并生成包含重新推导汇总计数的分层审计报告）；在 Cursor / Windsurf / Copilot CLI / Gemini CLI 上为 EXPERIMENTAL。

“读取规范 Agent 定义并以内联方式执行”的模式依赖 AI 客户端能够：

  1. 读取引用的文件路径
  2. 执行 Bash 以调用验证器脚本
  3. 将 Agent 定义正文视为当前轮次的操作指令

大多数 AI 客户端都支持以上三项。如果某项功能在特定客户端上不可靠，该客户端则会退回到手动调用验证器 + 手动进行跨领域检查。

参考文件

评论

支持 Markdown