关于 update-changelog
update-changelog 是用于按 Keep a Changelog 规范创建或更新变更日志的技能,供项目维护者按版本和类别记录变更。
主要功能
- 01查找或创建变更日志文件
- 02添加带日期的版本章节
- 03按变更类型分组条目
- 04以简洁项目符号整理内容
适用场景
- 01按版本记录一次发布变更
- 02为尚无日志的项目创建变更日志
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nweii/ agent-stuff --skill update-changelog安装后在 Claude Code 中输入/update-changelog确认已加载。
附带文件skill-plugin-conventions.md
详细介绍
更新变更日志
按照 Keep a Changelog 约定更新变更日志文件。
用法
/update-changelog <version> <change_type> <message>
参数
<version>:版本号(例如,“1.1.0”)<change_type>:以下其中一项:“added”、“changed”、“deprecated”、“removed”、“fixed”、“security”<message>:变更说明
流程
- 检查是否存在变更日志文件(CHANGELOG.md 或 changelog.md),如不存在则创建
- 查找或创建指定版本的区块,并使用今天的日期
- 在相应的变更类型标题下添加新条目
- 按照 Keep a Changelog 约定进行格式化
- 将更新后的变更日志写回文件
格式约定
- 按类型对变更分组(Added、Changed、Deprecated、Removed、Fixed、Security)
- 以项目符号列出变更
- 为版本区块添加日期(YYYY-MM-DD)
- 条目简洁明了,同时包含必要描述
- 不使用表情符号
输出示例
## [1.2.0] - 2025-01-24
### Added
- New markdown to BlockDoc conversion feature
### Fixed
- Bug in HTML renderer causing incorrect output
插件变更日志
有关插件变更日志格式,请参阅 skill-plugin-conventions.md。
评论
支持 Markdown