mcpField
U
utility-pm-changelog-curator

utility-pm-changelog-curator

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

关于 utility-pm-changelog-curator

用于从 Git 提交记录起草 CHANGELOG 的跨客户端调度技能，面向准备发布的产品团队。Claude Code 中调用原生子 Agent，其他客户端则读取定义并按仓库规范整理草稿；结果供审核，不会直接提交。

主要功能

  1. 01按标签范围梳理 Git 提交
  2. 02依据仓库规范分类并改写条目
  3. 03支持目标版本与仅已提交内容选项
  4. 04在 Claude Code 或其他客户端执行
  5. 05生成待审核草稿，不直接提交

适用场景

  1. 01根据两个版本标签准备发布说明
  2. 02为 CHANGELOG 起草公开变更条目
  3. 03在非 Claude Code 客户端整理提交记录
  4. 04配合发布流程生成 CHANGELOG 草稿

安装

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

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

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

包含的文件

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

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

详细介绍

PM Changelog Curator（分发技能）

pm-changelog-curator 子 Agent 的跨客户端分发包装器。检测运行时；在 Claude Code 上分发给原生子 Agent；在非 Claude 客户端上读取 agents/pm-changelog-curator.md 并内联执行。

适用场景

  • 你正在准备发布，并希望根据两个标签之间的 git log 起草 CHANGELOG
  • 你正在使用不支持原生 pm-changelog-curator 子 Agent 的非 Claude AI 客户端
  • 你希望草稿遵循 pm-skills 的 CHANGELOG 规范（不引用内部备注、不使用 em dash、仅使用公开路径），而无需手动应用这些规则

不适用场景

  • 你想直接提交 CHANGELOG 条目（此技能生成供审核的草稿，不会提交）
  • 你想审核 PM 文档 → 使用 utility-pm-critic
  • 你想进行全仓库治理审计 → 使用 utility-pm-skill-auditor
  • 你想要完整的引导式发布流程 → 使用 utility-pm-release-conductor（它会在 G2 阶段调用此技能）

说明

运行时检测步骤。 确定正在调用此技能的 AI 客户端。

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

使用用户提供的参数调用 @agent-pm-skills:pm-changelog-curator。如果 $ARGUMENTS 中存在 --since-tag、--target-version、--committed-only，则传递这些参数。将子 Agent 的草稿返回给用户。

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

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

  1. 读取规范子 Agent 定义文件 agents/pm-changelog-curator.md
  2. 将该文件中的系统提示词正文作为操作说明执行
  3. 按照子 Agent 定义中记录的 8 步起草流程执行（确定范围 -> 阅读规范规则 -> 检查工作区 -> 列出提交 -> 分类 -> 分组 -> 改写 -> 确定目标版本 -> 输出草稿）
  4. 应用 $ARGUMENTS 中的 --since-tag、--target-version 和 --committed-only 参数
  5. 按照主计划 D26 返回分层输出（完整 CHANGELOG 草稿 + 状态摘要 + 状态 YAML）

跨客户端说明

此分发技能要求 AI 客户端能够：

  1. 执行 Bash 来运行 git log、git describe 和 git status
  2. 读取 CLAUDE.md 规范规则和现有 CHANGELOG.md 格式参考
  3. 读取规范子 Agent 定义文件
  4. 将 Agent 正文视为操作说明

有关规范的跨客户端状态，请参阅子 Agent 兼容性矩阵。截至 v2.16.0，此技能的状态摘要：Claude Code + Codex CLI 上为 PRODUCTION（Codex CLI 已成功运行 git log、读取 CLAUDE.md 规范规则、起草整洁的 CHANGELOG 条目，并正确拒绝处理脏工作区）；Cursor / Windsurf / Copilot CLI / Gemini CLI 上为 EXPERIMENTAL。如果某个客户端不可靠，请回退到手动运行 git log，并参考 CLAUDE.md 手动起草。

参考文件

评论

支持 Markdown