gitlink-changelog

版本变更对比的 GitLink AI Agent Skill。对比提交历史，按 conventional commits 归类生成结构化变更日志，自动标注不兼容变更与贡献者。

GitLink 智能化服务开源项目贡献赛 子赛题二（编写和丰富 GitLink Skills） 参赛作品。作者：Ct201314

它解决什么

发版时整理 changelog 是件繁琐的体力活。gitlink-changelog 自动化它：

• 把提交按 feat/fix/docs/perf 等类型分组
• 自动识别并高亮不兼容变更（! 与 BREAKING CHANGE）
• 提取每条变更的 scope、短 sha 与提交者
• 汇总本次范围内的全部贡献者

安装与使用

作为 Agent Skill：把 SKILL.md 与 scripts/ 放入 Agent 技能目录，提出诉求即可触发。

直接运行：

python scripts/changelog.py --owner Gitlink --repo gitlink-cli
python scripts/changelog.py --owner Gitlink --repo gitlink-cli --since v0.1.17 --until v0.1.18

目录结构

gitlink-changelog/
├── SKILL.md
├── scripts/  glapi.py + changelog.py
├── references/  api-reference.md + conventions.md
├── examples/  真实变更日志
├── tests/test_changelog.py（13 用例）
├── requirements.txt
└── LICENSE

真实验证

在 Gitlink/gitlink-cli（v0.1.17→v0.1.18）上运行，127 条提交中归类出 70 条规范化提交： 新功能 27 / 缺陷修复 16 / 文档 15 等，识别 15 位贡献者。产物见 examples/。

python -m pytest tests/ -q   # 13 passed

许可证

Mulan PSL v2，与 gitlink-cli 主仓库保持一致。