- 📌Skill基础信息
- Skill名称:changelog
- 来源:社区第三方(alunduil/alunduil-chezmoi)
- 运行宿主:Claude-Code CLI(需明确宿主工具)
- 核心定位:遵循Keep a Changelog 1.1.0规范,自动化生成或更新
CHANGELOG.md文件,适用于项目版本变更记录维护场景,尤其适合需要手动管理变更日志的开源项目。
- 🧩内部核心组成
- 核心能力:
- 自动检测并规避已有自动化工具(如changesets/release-please等)
- 支持语义化版本(semver 2.0.0)和Haskell PVP双版本规范
- 区分首次发布前(单Added分类)和正式发布后(六分类)模式
- 关键规则:
```markdown
1. 变更条目必须对最终用户可见(非开发者内部变更)
2. 已发布版本内容不可修改
3. 自动识别Haskell项目切换PVP版本规范
```
- 🛠安装与启用方式
- 安装命令:
```bash
skills install --user alunduil/alunduil-chezmoi
```
- 前置要求:
- Git版本控制系统
- 项目需包含有效的版本控制历史
- 📋标准工作流
- 用户执行changelog生成指令
- Skill自动检测项目状态:
- 检查是否存在自动化工具配置 → 存在则退出(除非用户强制覆盖)
- 识别是否为Haskell项目 → 切换PVP版本规范
- 判断是否首次发布 → 决定分类模式
- 扫描Git历史变更:
- 提取git tag至HEAD之间的提交
- 过滤仅保留用户可见变更
- 按模式生成日志:
- 首次发布:所有变更归入### Added
- 常规更新:按6分类标准归类
- 输出符合Keep a Changelog规范的MD文件
- ⚠️关键限制、缺陷、注意事项
- 不支持的场景:
- 已使用changesets等自动化工具的项目
- 非Git管理的项目
- 无用户可见变更的纯技术债修复
- token消耗:中等(需解析Git历史)
- 生产建议:适合中小型开源项目,不推荐超大型项目全量使用
- ✅适用场景 & ❌不适合场景
| 场景类型 | 说明 |
|---|---|
| ✅适合 | 手动维护CHANGELOG的开源项目、需要严格遵循Keep a Changelog规范的项目、Haskell生态项目 |
| ❌不适合 | 已配置自动化发布流水线的项目、内部工具类项目(无用户可见变更)、历史版本混乱无tag的项目 |
如何安装
skills install --user alunduil/alunduil-chezmoi通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com