关于 utility-pm-release-conductor
utility-pm-release-conductor 是用于跨 AI 客户端执行 PM 技能发布的调度技能。它在 Claude Code 中调用原生子 Agent,在其他客户端内联执行发布流程,并要求经过六道关卡和明确确认。
主要功能
- 01六道关卡的发布流程
- 02按运行环境调度
- 03内联审计与变更日志步骤
- 04每道关卡均需确认
- 05提供试运行验证指引
适用场景
- 01在 Claude Code 以外执行 pm-skills 发布
- 02用 --dry-run 演练 Codex CLI 发布
- 03在 Claude Code 中采用技能调用语义
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ product-on-purpose/ pm-skills --skill utility-pm-release-conductor安装后在 Claude Code 中输入/utility-pm-release-conductor确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
HISTORY.mdevals/trigger-fixtures.jsonreferences/EXAMPLE.mdTEMPLATE.md详细介绍
PM 发布协调器(Dispatch Skill)
pm-release-conductor 子代理的跨客户端调度封装。检测运行时;在 Claude Code 上调度原生子代理;在非 Claude 客户端上读取 agents/pm-release-conductor.md,并通过“引用 + 内联执行”模式内联链式组合。
状态摘要(v2.16.0): 在 Claude Code 上为生产就绪(原生子代理路径)。根据
gate-test-results_2026-05-17_codex.md,已于 2026-05-17 在 Codex CLI 上通过干运行验证;尚未在 Codex CLI 上独立执行真实发布,因此请谨慎使用,并先运行--dry-run进行预演。在 Cursor / Windsurf / Copilot CLI / Gemini CLI 上为实验性功能(v2.16.0 发布时尚未测试)。关于权威安全使用矩阵、已验证内容详情及 v2.17 扩展计划,请参阅子代理兼容性矩阵。要在非 Claude 客户端上进行真实发布,理想情况下应先在该特定客户端上重新运行
maintainer-gate-testing-codex.md中的测试框架。
适用场景
- 你正在非 Claude 客户端(Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI)上执行 pm-skills 发布
- 你希望采用与 pm-release-conductor 在 Claude Code 上执行的相同 6 道关卡流程,并在相关关卡内联审计员 + 策展员行为
- 你明确希望在 Claude Code 上使用技能调用语义,而非子代理语义(较少见;在 Claude Code 上优先使用原生子代理)
不适用场景
- 你只需评审 PM 产物 -> 使用
utility-pm-critic - 你只需进行治理审计(而非发布) -> 使用
utility-pm-skill-auditor - 你只需起草 CHANGELOG(而非发布) -> 使用
utility-pm-changelog-curator - 你想在没有明确关卡确认的情况下执行发布操作 -> 协调器会拒绝绕过流程;正确做法是在协调器之外手动发布
说明
运行时检测步骤。 确定调用此技能的 AI 客户端。
如果你在安装了 pm-skills 插件的 Claude Code 中运行
使用 $ARGUMENTS 中用户提供的目标版本 + 可选标志调用 @agent-pm-skills:pm-release-conductor。原生子代理将遍历 6 道关卡,并通过 Agent 工具原生串联 pm-skill-auditor(G0、G2.5)和 pm-changelog-curator(G2)。将协调器逐关卡的输出返回给用户。
如果你使用的是其他 AI 客户端
Codex CLI、Cursor、Windsurf、Copilot、Gemini CLI,或任何不原生支持 pm-skills 插件子 Agent 的其他客户端:
- 阅读规范子 Agent 定义:
agents/pm-release-conductor.md - 阅读规范操作手册:
docs/contributing/release-runbook.md(conductor 用于定义关卡的参考来源) - 将系统提示词正文作为操作指令执行
- 按顺序执行 6 个关卡。在需要链式组合的关卡中:
- G0(预标记就绪): 不要链式调用 pm-skill-auditor,而是阅读
agents/pm-skill-auditor.md,并在当前上下文中执行 auditor 的 4 步审计流程。记录分层输出(完整发现 + 状态摘要 + 状态 YAML)。将状态 YAML 作为 G0 子检查 5 的输入。 - G2(版本号更新 + CHANGELOG 准备): 不要链式调用 pm-changelog-curator,而是阅读
agents/pm-changelog-curator.md,并在当前上下文中执行 curator 的 8 步起草流程。记录分层输出。将状态 YAML 作为 G2 子检查 3 的输入。 - G2.5(重新验证): 针对新的 HEAD,在子检查 5 中重新执行内联 auditor。
- G0(预标记就绪): 不要链式调用 pm-skill-auditor,而是阅读
- 在每个关卡边界暂停,等待维护者明确确认
- 拒绝绕过尝试;遵循拒绝协议
- 按 D22,在 G3 仅标记 G2.5 捕获的 SHA
- 在整个流程中按关卡逐一返回输出
“参考 + 内联执行”模式可实现跨客户端的链式组合兼容性。Phase 2 GATE C 子尖峰用于验证此模式的可靠性。
非 Claude 内联执行的重要注意事项
由于非 Claude 客户端无法原生进行链式调用,auditor 和 curator 的行为会在非 Claude 客户端上与 conductor 在同一上下文窗口中运行。这会带来以下影响:
- 上下文预算。 合并后的 token 预算(conductor + 内联 auditor + 内联 curator + 它们读取的子文件)在较长的发布流程中可能接近上下文限制。请做好相应规划。
- 工具授权。 conductor 的工具列表包含 Bash、Read、Edit、Grep、Glob、Agent。auditor 需要 Bash + Read + Grep + Glob。curator 需要 Bash + Read + Grep。非 Claude 客户端上的内联执行应能访问所有这些工具(即不能处于只读模式)。
- 拒绝级联。 如果内联 auditor 拒绝执行(例如,无法调用验证器),conductor 的 G0 子检查 5 将失败,关卡会暂停。G2 的 curator 也一样。
参考文件
- 规范子 Agent 定义:
agents/pm-release-conductor.md - 规范操作手册:
docs/contributing/release-runbook.md - 行为规范:
docs/internal/release-plans/v2.16.0/spec_pm-release-conductor.md - 链式子 Agent(在 G0 + G2.5 内联):
agents/pm-skill-auditor.md - 链式子 Agent(在 G2 内联):
agents/pm-changelog-curator.md - 预标记验证器套件:
scripts/pre-tag-validate.{sh,ps1} - 运行时组件目录:
docs/reference/runtime-components.md - 输出模板:
references/TEMPLATE.md - 完整示例:
references/EXAMPLE.md