Agent skill

Changelog Generator

by didi in didi/mpx

通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。

Apache-2.0Auto-check passedDevelopment

Install Changelog Generator

skills CLI
$ npx skills add didi/mpx --skill changelog-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install didi/mpx changelog-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/didi/mpx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/changelog-generator .claude/skills/changelog-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
changelog-generator
GitHub stars
3.9k
Token cost
~640 tokens
SKILL.md length
45 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。

  • Works in 3 steps: New Features:当前版本的新增功能与特性,按需可选生成 → Bug Fixes:当前版本修复的bug,按需可选生成 → Packages:当前版本涉及的npm包版本变更记录,通常可以从当前活跃终端的日志…
  • Tasks that involve Changelog and release notes
  • SKILL.md covers 内容结构, 文档与 Skill 同步约束 and 内容示例
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Changelog Generator is an agent skill from didi/mpx. 通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Changelog and release notes. It works with Git, WeChat and VitePress. The repository describes itself as: Mpx,一款具有优秀开发体验和深度性能优化的增强型跨端小程序框架. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “创建/生成变更日志”
  • “创建/生成changelog”
  • “/changelog-generator”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. New Features:当前版本的新增功能与特性,按需可选生成
  2. Bug Fixes:当前版本修复的bug,按需可选生成
  3. Packages:当前版本涉及的npm包版本变更记录,通常可以从当前活跃终端的日志信息中查询到,如无法获取到准确信息可以留空

What it can do on your machine

Read from SKILL.md and the folder at commit 53b45fb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Changelog Generator loads about 640 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 45 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~640

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from didi/mpx at commit 53b45fb, republished under its Apache-2.0 licence (© didi). 45 words, ~640 tokens.

Download SKILL.mdSave it as .claude/skills/changelog-generator/SKILL.md (or your agent's skills folder).
name
changelog-generator
description
通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。

创建版本变更日志

通过当前最新版本与上一版本间的git提交记录(查看两个版本间的commits信息)和代码变更(查看两个版本间的代码diff),生成版本变更日志

内容结构

变更日志包括以下三项内容:

  1. New Features:当前版本的新增功能与特性,按需可选生成
  2. Bug Fixes:当前版本修复的bug,按需可选生成
  3. Packages:当前版本涉及的npm包版本变更记录,通常可以从当前活跃终端的日志信息中查询到,如无法获取到准确信息可以留空

严格遵循上述内容结构,不要私自添加其他内容,过于细碎的变更如变量重命名,实现微调等可以不用列出。

生成内容写入到 changelogs/<version>.md 文件中。

文档与 Skill 同步约束

生成变更日志后,检查版本变更内容是否涉及用户开发使用方式(对外暴露的 API、配置项、模板/样式/脚本/JSON 能力、CLI 参数、生命周期、内建组件、环境 API、跨端行为差异等),如涉及则必须同步更新对应的文档与 Skill:

  • 文档:更新 docs-vitepress/ 下对应位置的 .md,并按 docs-vitepress/AGENTS.md 的归档原则与索引要求同步侧边栏、导航及目录索引。
  • Skill:当变更涉及跨端输出 RN 的能力(模板/脚本/样式/JSON 配置维度、基础组件、环境 API 在 RN 平台的支持情况、Mpx2RN 编译行为等)时,必须同步更新 .agents/skills/mpx2rn/ 下的相关知识库。
  • 仅修改内部实现、重构、测试、构建脚本而不改变对外使用方式的变更项,无需更新文档或 Skill。

内容示例

markdown
# v2.10.18

## ✨ New Features 
- **跨端输出 React Native**
  - Swiper 增强 : 支持 indicator-margin 、 indicator-width 和 height 属性,提升了轮播图组件的定制能力。
  - Input 增强 :
    - 新增支持 keyboard 属性,并将 keyboardType 自动映射为 RN 的 inputMode 。
    - 新增支持 hold-keyboard 属性。
  - 响应式布局优化 :
    - 优化 rpx 、 vh 、 vw 单位机制,支持在屏幕尺寸变化时自动刷新。
    - 所有 CSS 单位计算基准由 window 改为 screen。
    - onResize 触发时机与微信小程序保持一致。
    - 新增 rnConfig.customDimensionsInfo 配置,支持自定义修改基准尺寸信息。
  - 动画支持 : 新增对颜色插值和百分比动画的支持,增强了动画表现力。
  - 其他 : 增加对页面脚本错误的捕获和处理。
  
- **快手小程序**
  - 新增支持跨端输出快手小程序。

- **其他优化**
  - 优化 global.__formatValue 实现,提升数据处理效率。

## 🐛 Bug Fixes 
- **跨端输出 React Native**
  - 样式与渲染 :
    - 修复 CSS 变量使用非法 fallback 值导致的应用崩溃问题。
    - 修复 background-size 在处理百分比尺寸时的计算逻辑。
    - 修复 Textarea 开启 auto-height 后 min-height 失效的问题。
    - 修复样式块中单独 import CSS 文件时的报错。
   
  - 交互与事件 :
    - 修复 Android 平台多个输入框切换聚焦时的逻辑时序问题。
    - 修复 iOS 平台 Input 组件一些边界场景下未触发 bindfocus 事件的问题。
  - 构建与运行 :
    - 修复 Swiper 开启指示点时 key 重复导致的报错。
    - 修复异步分包加载时 global 变量未被正确处理的问题。
    - 修复 wx:elif 静态为 true 时的构建报错。
  
- **跨端输出 Web**
  - 修复页面下拉刷新与 position: fixed 同时存在时的渲染异常。

- **支付宝小程序**
  - 修复组件 setup context报错异常。

- **其他修复**
  - 修复 defineOptions 使用 ObjectMethod 语法时的构建报错。
  - 修复 getBLEDeviceCharacteristics 取值错误。
  - 修复 transform 属性排序不一致导致的动画闪烁问题。
  - 修复路由超时错误信息中缺失 type 与 url 的问题。

## 📦 Packages
- @mpxjs/api-proxy: 2.10.17 => 2.10.18
- @mpxjs/core: 2.10.17 => 2.10.18
- @mpxjs/fetch: 2.10.17 => 2.10.18
- @mpxjs/pinia: 2.10.17 => 2.10.18
- @mpxjs/store: 2.10.17 => 2.10.18
- @mpxjs/utils: 2.10.17 => 2.10.18
- @mpxjs/webpack-plugin: 2.10.17 => 2.10.18

© didi, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/changelog-generator of didi/mpx.

Open the folder on GitHubat commit 53b45fb

Compare with similar skills

Changelog Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Changelog Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changelog Generator this skilldidi/mpx3.9k—~640Automated safety check: PassApache-2.0
Releasing Php Packageyansongda/pay5.4k—~1.6kAutomated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT
Mole Release Notes Publishertw93/Mole70k—~1.9kAutomated safety check: PassGPL-3.0
Release Bumpjamiepine/voicebox57k—~1.1kAutomated safety check: PassMIT

Similar skills

  • A skill your agent uses when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing

    5.4k GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release Bump

    jamiepine/voicebox

    Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.

    57k GitHub stars~1.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    103k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

More from didi/mpx

  • 审计存量 Mpx 项目迁移到“mode 只负责目标筛选、srcMode 只负责源码方言”的新版编译语义。只要用户提到升级 Mpx 后检查条件编译、排查 .ali/.swan 等条件文件、mode/src-mode 区块、@mode/@mode、modeRules/srcModeRules 或外部模板迁移,就应使用本 Skill;不用于与该语义变更无关的普通 Mpx 升级。

    3.9k GitHub stars~731 tokensUpdated today
    Auto-check passed
  • Mpx2rn

    didi/mpx

    Mpx 跨端输出 RN(简称 Mpx2RN 或 Mpx2DRN)的开发适配指南,覆盖模板、脚本、样式、JSON 配置四大维度。当用户进行 Mpx2RN 相关任务时强制调用,包括但不限于:技术方案设计、页面 / 组件的开发迭代、旧项目跨端适配改造、编译和运行时报错排查、Code Review 等。当用户问题不涉及 Mpx2RN 时不应调用,如 Mpx 小程序开发问题,RN…

    3.9k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Mpx 跨端输出 RN(简称 Mpx2RN 或 Mpx2DRN)的开发适配指南,覆盖模板、脚本、样式、JSON 配置四大维度。当用户进行 Mpx2RN 相关任务时强制调用,包括但不限于:技术方案设计、页面 / 组件的开发迭代、旧项目跨端适配改造、编译和运行时报错排查、Code Review 等。当用户问题不涉及 Mpx2RN 时不应调用,如 Mpx 小程序开发问题,RN…

    3.9k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Review Loop

    didi/mpx

    当用户要求评审循环、自评审工作流、planner/reviewer/coder/code-reviewer 协作、先方案后编码、多轮 Agent 评审,或要求稳定的子 Agent 工作流依次产出方案、等待用户确认、实现代码、评审差异并保留修订记录时,使用此 Skill。此 Skill 必须使用真实子 Agent,不得退化为单 Agent 角色扮演。

    3.9k GitHub stars~828 tokensUpdated today
    Auto-check passed
  • Helps when network-related commands (like curl, git, npm, pip, brew) are failing, timing out, or running slowly due to network issues.

    3.9k GitHub stars~464 tokensUpdated today
    Auto-check passed
  • Skill2gene

    didi/mpx

    将传统文档导向的 Procedural Skill 转换为紧凑的 Strategy Gene 格式。基于论文 "From Procedural Skills to Strategy Genes" 的 Gene Evolution Protocol (GEP),将 ~2500 token 的文档型 Skill 蒸馏为 ~200-300 token 的控制型 Gene 集合。当用户要求将…

    3.9k GitHub stars~558 tokensUpdated today
    Auto-check passed

Categories

Questions about Changelog Generator

What does Changelog Generator do?

通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。. Changelog Generator is an agent skill from didi/mpx.

When should I use Changelog Generator?

Changelog Generator fits situations like: tasks that involve Changelog and release notes.

How do I install Changelog Generator in Claude Code?

Run `npx skills add didi/mpx --skill changelog-generator -a claude-code`. Or copy the skill folder (.agents/skills/changelog-generator in didi/mpx) into .claude/skills/changelog-generator in your project. Claude Code loads it when a task matches its description.

How do I install Changelog Generator in Codex?

Run `npx skills add didi/mpx --skill changelog-generator -a codex`. Or copy the skill folder (.agents/skills/changelog-generator in didi/mpx) into .agents/skills/changelog-generator in your project. Codex loads it when a task matches its description.

Can I use Changelog Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add didi/mpx --skill changelog-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/changelog-generator, .gemini/skills/changelog-generator, .github/skills/changelog-generator and .opencode/skills/changelog-generator in your project.

What does Changelog Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Changelog Generator is instructions for the agent only.

Does Changelog Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Changelog Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Changelog Generator use?

Changelog Generator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Changelog Generator use?

About 640 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Changelog Generator?

Skills that share tags, products or a category with Changelog Generator: Releasing Php Package (yansongda/pay, 5.4k stars), React Router Release Notes Prep (remix-run/react-router, 57k stars), Draft Release Notes (jamiepine/voicebox, 57k stars) and Mole Release Notes Publisher (tw93/Mole, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changelog Generator?

didi (a GitHub organization) maintains it in didi/mpx, which has 3,941 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 9, 2026.

Source: didi/mpx on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.