mcpField
U
utility-pm-release-conductor

utility-pm-release-conductor

github.com/product-on-purpose开发769600 次安装4 天前更新
代码仓库

关于 utility-pm-release-conductor

utility-pm-release-conductor 是用于跨 AI 客户端执行 PM 技能发布的调度技能。它在 Claude Code 中调用原生子 Agent,在其他客户端内联执行发布流程,并要求经过六道关卡和明确确认。

主要功能

  1. 01六道关卡的发布流程
  2. 02按运行环境调度
  3. 03内联审计与变更日志步骤
  4. 04每道关卡均需确认
  5. 05提供试运行验证指引

适用场景

  1. 01在 Claude Code 以外执行 pm-skills 发布
  2. 02用 --dry-run 演练 Codex CLI 发布
  3. 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.md
evals/
trigger-fixtures.json
references/
EXAMPLE.md
TEMPLATE.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 的其他客户端:

  1. 阅读规范子 Agent 定义:agents/pm-release-conductor.md
  2. 阅读规范操作手册:docs/contributing/release-runbook.md(conductor 用于定义关卡的参考来源)
  3. 将系统提示词正文作为操作指令执行
  4. 按顺序执行 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。
  5. 在每个关卡边界暂停,等待维护者明确确认
  6. 拒绝绕过尝试;遵循拒绝协议
  7. 按 D22,在 G3 仅标记 G2.5 捕获的 SHA
  8. 在整个流程中按关卡逐一返回输出

“参考 + 内联执行”模式可实现跨客户端的链式组合兼容性。Phase 2 GATE C 子尖峰用于验证此模式的可靠性。

非 Claude 内联执行的重要注意事项

由于非 Claude 客户端无法原生进行链式调用,auditor 和 curator 的行为会在非 Claude 客户端上与 conductor 在同一上下文窗口中运行。这会带来以下影响:

  1. 上下文预算。 合并后的 token 预算(conductor + 内联 auditor + 内联 curator + 它们读取的子文件)在较长的发布流程中可能接近上下文限制。请做好相应规划。
  2. 工具授权。 conductor 的工具列表包含 Bash、Read、Edit、Grep、Glob、Agent。auditor 需要 Bash + Read + Grep + Glob。curator 需要 Bash + Read + Grep。非 Claude 客户端上的内联执行应能访问所有这些工具(即不能处于只读模式)。
  3. 拒绝级联。 如果内联 auditor 拒绝执行(例如,无法调用验证器),conductor 的 G0 子检查 5 将失败,关卡会暂停。G2 的 curator 也一样。

参考文件

评论

支持 Markdown