git-changelog

Git Changelog 是一款专注于自动化生成版本变更日志的文档型 Skill，它通过解析 Git 仓库的提交历史，基于 Conventional Commits 规范自动分类和整理发布说明，帮助开发团队高效完成版本发布文档工作。

核心用法方面，该 Skill 首先自动检测版本范围，通过 git tag 命令识别最新标签，获取自上次发布以来的所有提交记录；若仓库尚无标签，则默认读取最近 50 条提交。随后，它使用 Conventional Commits 规范解析提交信息，自动将 feat: 归类为功能更新、fix: 归类为缺陷修复、BREAKING CHANGE 标记为破坏性变更等，同时支持为非规范提交设置"其他变更"分类。Skill 还能自动识别 GitHub/GitLab 远程仓库地址，为每条提交生成可点击的链接。最终输出符合业界标准的 Markdown 格式变更日志，并支持追加写入 CHANGELOG.md 文件。

显著优点包括：完全基于本地 Git 工具，无需 API 密钥或网络连接；严格遵循 Conventional Commits 行业标准，确保团队协作规范统一；内置完善的边界情况处理机制，如支持 Monorepo 场景下的路径过滤、自定义日期范围查询、无标签仓库的兜底方案等；输出格式专业美观，自带 Emoji 分类标识，提升发布说明的可读性。

潜在缺点在于：高度依赖 Conventional Commits 规范，若团队未采用该提交规范，分类效果将大打折扣；作为纯文档型 Skill，它仅提供操作指南而非直接执行，需要用户手动复制命令运行；来源可信度为 T3 级（个人维护项目），虽经安全审计但仍需用户自行判断内容可靠性；对于复杂的自定义格式需求，提供的模板可能不够灵活。

适合的目标群体主要包括：开源项目维护者、企业版本发布管理员、遵循 DevOps 流程的开发团队、需要定期生成发布说明的产品经理，以及希望规范 Git 工作流程的技术团队。

使用风险极低，该 Skill 仅包含只读的 Git 查询命令（如 git log、git tag），不涉及文件修改、系统命令执行或网络数据传输。主要风险在于 T3 来源的维护稳定性，建议在生产环境使用前进行充分测试。性能方面，对于拥有数万条提交的大型仓库，日志查询可能需要较长时间，建议配合日期范围参数使用。