File contents 创建版本变更日志
通过当前最新版本与上一版本间的git提交记录 (查看两个版本间的commits信息)和代码变更 (查看两个版本间的代码diff),生成版本变更日志
内容结构
变更日志包括以下三项内容:
New Features :当前版本的新增功能与特性,按需可选生成
Bug Fixes :当前版本修复的bug,按需可选生成
Packages :当前版本涉及的npm包版本变更记录,通常可以从当前活跃终端的日志信息中查询到,如无法获取到准确信息可以留空
严格遵循上述内容结构,不要私自添加其他内容,过于细碎的变更如变量重命名,实现微调等可以不用列出。
生成内容写入到 changelogs/.md 文件中。
文档与 Skill 同步约束
生成变更日志后,检查版本变更内容是否涉及用户开发使用方式 (对外暴露的 API、配置项、模板/样式/脚本/JSON 能力、CLI 参数、生命周期、内建组件、环境 API、跨端行为差异等),如涉及则必须同步更新对应的文档与 Skill:
文档 :更新 docs-vitepress/ 下对应位置的 .md,并按 docs-vitepress/AGENTS.md 的归档原则与索引要求同步侧边栏、导航及目录索引。
Skill :当变更涉及跨端输出 RN 的能力 (模板/脚本/样式/JSON 配置维度、基础组件、环境 API 在 RN 平台的支持情况、Mpx2RN 编译行为等)时,必须同步更新 .agents/skills/mpx2rn/ 下的相关知识库。
仅修改内部实现、重构、测试、构建脚本而不改变对外使用方式的变更项,无需更新文档或 Skill。
内容示例
# 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
1 --- 2 name: changelog-generator 3 description: Changelog Generator 4 --- 5 6 # 创建版本变更日志 7 8 通过当前最新版本与上一版本间的**git提交记录**(查看两个版本间的commits信息)和**代码变更**(查看两个版本间的代码diff),生成版本变更日志 9 10 ## 内容结构 11 12 变更日志包括以下三项内容: 13 14 1. **New Features**:当前版本的新增功能与特性,按需可选生成 15 2. **Bug Fixes**:当前版本修复的bug,按需可选生成 16 3. **Packages**:当前版本涉及的npm包版本变更记录,通常可以从当前活跃终端的日志信息中查询到,如无法获取到准确信息可以留空 17 18 严格遵循上述内容结构,不要私自添加其他内容,过于细碎的变更如变量重命名,实现微调等可以不用列出。 19 20 生成内容写入到 changelogs/<version>.md 文件中。 21 22 ## 文档与 Skill 同步约束 23 24 生成变更日志后,检查版本变更内容是否涉及**用户开发使用方式**(对外暴露的 API、配置项、模板/样式/脚本/JSON 能力、CLI 参数、生命周期、内建组件、环境 API、跨端行为差异等),如涉及则必须同步更新对应的文档与 Skill: 25 26 - **文档**:更新 [docs-vitepress/](docs-vitepress/) 下对应位置的 `.md`,并按 [docs-vitepress/AGENTS.md](docs-vitepress/AGENTS.md) 的归档原则与索引要求同步侧边栏、导航及目录索引。 27 - **Skill**:当变更涉及**跨端输出 RN 的能力**(模板/脚本/样式/JSON 配置维度、基础组件、环境 API 在 RN 平台的支持情况、Mpx2RN 编译行为等)时,必须同步更新 [.agents/skills/mpx2rn/](.agents/skills/mpx2rn/) 下的相关知识库。 28 - 仅修改内部实现、重构、测试、构建脚本而不改变对外使用方式的变更项,无需更新文档或 Skill。 29 30 ## 内容示例 31 32 ```markdown 33 # v2.10.18 34 35 ## ✨ New Features 36 - **跨端输出 React Native** 37 - Swiper 增强 : 支持 indicator-margin 、 indicator-width 和 height 属性,提升了轮播图组件的定制能力。 38 - Input 增强 : 39 - 新增支持 keyboard 属性,并将 keyboardType 自动映射为 RN 的 inputMode 。 40 - 新增支持 hold-keyboard 属性。 41 - 响应式布局优化 : 42 - 优化 rpx 、 vh 、 vw 单位机制,支持在屏幕尺寸变化时自动刷新。 43 - 所有 CSS 单位计算基准由 window 改为 screen。 44 - onResize 触发时机与微信小程序保持一致。 45 - 新增 rnConfig.customDimensionsInfo 配置,支持自定义修改基准尺寸信息。 46 - 动画支持 : 新增对颜色插值和百分比动画的支持,增强了动画表现力。 47 - 其他 : 增加对页面脚本错误的捕获和处理。 48 49 - **快手小程序** 50 - 新增支持跨端输出快手小程序。 51 52 - **其他优化** 53 - 优化 global.__formatValue 实现,提升数据处理效率。 54 55 ## 🐛 Bug Fixes 56 - **跨端输出 React Native** 57 - 样式与渲染 : 58 - 修复 CSS 变量使用非法 fallback 值导致的应用崩溃问题。 59 - 修复 background-size 在处理百分比尺寸时的计算逻辑。 60 - 修复 Textarea 开启 auto-height 后 min-height 失效的问题。 61 - 修复样式块中单独 import CSS 文件时的报错。 62 63 - 交互与事件 : 64 - 修复 Android 平台多个输入框切换聚焦时的逻辑时序问题。 65 - 修复 iOS 平台 Input 组件一些边界场景下未触发 bindfocus 事件的问题。 66 - 构建与运行 : 67 - 修复 Swiper 开启指示点时 key 重复导致的报错。 68 - 修复异步分包加载时 global 变量未被正确处理的问题。 69 - 修复 wx:elif 静态为 true 时的构建报错。 70 71 - **跨端输出 Web** 72 - 修复页面下拉刷新与 position: fixed 同时存在时的渲染异常。 73 74 - **支付宝小程序** 75 - 修复组件 setup context报错异常。 76 77 - **其他修复** 78 - 修复 defineOptions 使用 ObjectMethod 语法时的构建报错。 79 - 修复 getBLEDeviceCharacteristics 取值错误。 80 - 修复 transform 属性排序不一致导致的动画闪烁问题。 81 - 修复路由超时错误信息中缺失 type 与 url 的问题。 82 83 ## 📦 Packages 84 - @mpxjs/api-proxy: 2.10.17 => 2.10.18 85 - @mpxjs/core: 2.10.17 => 2.10.18 86 - @mpxjs/fetch: 2.10.17 => 2.10.18 87 - @mpxjs/pinia: 2.10.17 => 2.10.18 88 - @mpxjs/store: 2.10.17 => 2.10.18 89 - @mpxjs/utils: 2.10.17 => 2.10.18 90 - @mpxjs/webpack-plugin: 2.10.17 => 2.10.18 91 ```
didi/mpx/tree/main/.agents/skills/changelog-generator commit 8aab7524e0
Frequently asked questions How do I install the Changelog Generator skill? Run npx skillmds@latest add didi/changelog-generator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Changelog Generator skill do? Changelog Generator It is listed under Coding & Dev Tools on SkillMD.
Is Changelog Generator safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Changelog Generator? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Changelog Generator free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Changelog Generator? didi (@didi) published this skill. Their other Agent Skills are listed on their SkillMD profile.