utility-pm-changelog-curator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

PM Changelog Curator (Dispatch Skill)

PM Changelog Curator（调度技能）

Cross-client dispatch wrapper for the

pm-changelog-curator

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

subagents/pm-changelog-curator.md

and executes inline on non-Claude clients.

适用于

pm-changelog-curator

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

subagents/pm-changelog-curator.md

并内联执行。

When to Use

使用场景

You are preparing a release and want a CHANGELOG draft from git log between two tags
You are running on a non-Claude AI client without native pm-changelog-curator sub-agent support
You want a draft that respects pm-skills CHANGELOG hygiene rules (no internal-notes references, no em-dashes, public paths only) without manually applying them

你正在准备版本发布，需要从两个标签之间的git日志生成CHANGELOG草稿
你使用的是非Claude AI客户端，且该客户端不原生支持pm-changelog-curator子代理
你希望生成的草稿自动遵循pm-skills的CHANGELOG规范规则（无内部注释引用、无破折号、仅使用公共路径），无需手动调整

When NOT to Use

不适用场景

You want to commit CHANGELOG entries directly (this skill produces a draft for review, not a commit)
You want to review a PM artifact -> use
```
utility-pm-critic
```
instead
You want a repo-wide governance audit -> use
```
utility-pm-skill-auditor
```
You want a full guided release flow -> use
```
utility-pm-release-conductor
```
(which chains to this skill at gate G2)

你想要直接提交CHANGELOG条目（本技能仅生成供审核的草稿，不执行提交操作）
你想要审核PM工件 -> 请改用
```
utility-pm-critic
```
你想要进行全仓库治理审核 -> 请改用
```
utility-pm-skill-auditor
```
你想要完整的引导式发布流程 -> 请使用
```
utility-pm-release-conductor
```
（该工具会在G2环节调用本技能）

Instructions

使用说明

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

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

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

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

Invoke

@agent-pm-changelog-curator

with the user's arguments. Pass

--since-tag

--target-version

--committed-only

from

$ARGUMENTS

if present. Return the sub-agent's draft to the user.

使用用户传入的参数调用

@agent-pm-changelog-curator

。若

$ARGUMENTS

中包含

--since-tag

、

--target-version

、

--committed-only

，则一并传递。将子代理生成的草稿返回给用户。

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-changelog-curator.md
```
Execute the system prompt body in that file as your operating instructions
Run the 8-step drafting flow documented in the sub-agent definition (establish range -> read hygiene rules -> check working tree -> enumerate commits -> classify -> group -> rewrite -> determine target version -> emit draft)

Apply

--since-tag

--target-version

, and

--committed-only

arguments from

$ARGUMENTS

Return the layered output per master plan D26 (full CHANGELOG draft + Status Summary + Status YAML)

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

读取
```
subagents/pm-changelog-curator.md
```
中的标准子代理定义
将该文件中的系统提示内容作为操作指令执行
执行子代理定义中记录的8步草稿生成流程（确定范围 -> 读取规范规则 -> 检查工作树 -> 枚举提交记录 -> 分类 -> 分组 -> 重写 -> 确定目标版本 -> 生成草稿）

应用

$ARGUMENTS

中的

--since-tag

、

--target-version

和

--committed-only

参数

返回符合总体规划D26的分层输出（完整CHANGELOG草稿 + 状态总结 + Status YAML）

Cross-Client Notes

跨客户端注意事项

The dispatch skill requires the AI client to:

Execute Bash for
```
git log
```
,
```
git describe
```
, and
```
git status
```
invocations
Read CLAUDE.md hygiene rules and existing CHANGELOG.md format reference
Read the canonical sub-agent definition file
Treat the agent body as operating instructions

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 ran git log + read CLAUDE.md hygiene rules + drafted clean CHANGELOG entries + correct dirty-tree refusal); EXPERIMENTAL on Cursor / Windsurf / Copilot CLI / Gemini CLI. If a client is unreliable, fall back to manual

git log

+ manual drafting using CLAUDE.md as the hygiene reference.

调度技能要求AI客户端具备以下能力：

能够执行Bash命令以调用
```
git log
```
、
```
git describe
```
和
```
git status
```
能够读取CLAUDE.md中的规范规则以及现有CHANGELOG.md的格式参考
能够读取标准子代理定义文件
能够将代理内容视为操作指令

如需了解标准跨客户端支持状态，请查看子代理兼容性矩阵。截至v2.16.0版本，本技能的支持情况总结：Claude Code + Codex CLI已进入生产环境（Codex CLI可成功运行git log、读取CLAUDE.md规范规则、生成整洁的CHANGELOG条目，并正确拒绝未清理的工作树）；Cursor / Windsurf / Copilot CLI / Gemini CLI处于实验阶段。若客户端不可靠，请退回到手动执行

git log

并以CLAUDE.md为规范参考手动撰写草稿。

Reference Files

参考文件

Canonical sub-agent definition:
```
subagents/pm-changelog-curator.md
```

Behavioral spec:

docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md

CHANGELOG hygiene rules source:
```
CLAUDE.md
```
(repo root)
Existing CHANGELOG.md format:
```
CHANGELOG.md
```
(root); v2.15.1 + v2.15.2 entries are canonical exemplars
Runtime components catalog:
```
docs/reference/runtime-components.md
```
Output template:
```
references/TEMPLATE.md
```
Worked example:
```
references/EXAMPLE.md
```

标准子代理定义：
```
subagents/pm-changelog-curator.md
```

行为规范：

docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md

CHANGELOG规范规则来源：
```
CLAUDE.md
```
（仓库根目录）
现有CHANGELOG.md格式：
```
CHANGELOG.md
```
（根目录）；v2.15.1和v2.15.2版本的条目为标准示例
运行时组件目录：
```
docs/reference/runtime-components.md
```
输出模板：
```
references/TEMPLATE.md
```
示例：
```
references/EXAMPLE.md
```