cc-changelog-plugin
为每次代码提交自动生成结构化、可搜索的变更日志条目。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:cc-changelog-plugin。 它的用途是:为每次代码提交自动生成结构化、可搜索的变更日志条目。 完整的 Skill 内容见:https://321skill.com/skills/cc-changelog-plugin/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“提交这些更改,并说明一下为什么重构了用户服务的认证逻辑。” 它会引导你详细描述本次变更的内容、原因、遇到的问题、测试情况以及后续计划,然后生成一个结构化的变更日志文件并完成 Git 提交。当你半年后需要回顾当时的决策背景时,只需在 `changelog/` 目录的索引中搜索关键词即可快速找到。
介绍
传统的单文件变更日志在合并时容易产生冲突,且随着时间推移会丢失上下文。Git Changelog Plugin 解决了这一痛点,它能在每次提交代码时,自动创建带有时间戳的独立日志文件,从根本上避免了合并冲突,并为每个编码会话保留了完整的决策背景、遇到的问题和解决方案。
使用时,你只需像往常一样让 Claude Code 提交代码,例如说“提交这些更改”或“让我们提交这个工作”。插件会自动触发,引导你填写变更详情,并最终在项目的 changelog/ 目录下生成一个结构化的 Markdown 文件。整个过程无缝集成到你的 Git 工作流中。
这个工具非常适合任何需要维护项目历史、进行团队协作或未来需要回溯代码变更原因的开发者。无论是独立开发者还是团队中的全栈工程师、后端开发,都能从中受益,建立起一个可搜索的项目演进知识库。
建议在项目初期就启用此插件,以积累完整的历史记录。对于微小的、无需记录的修改(如修复拼写错误),可以使用“Commit without changelog: …”的指令来跳过日志生成,保持日志的简洁和相关性。
核心特点
与传统的单文件变更日志不同,它通过为每次提交生成独立的、带时间戳的文件,彻底解决了合并冲突问题,并强制记录“为什么”而不仅仅是“改了什么”,构建了一个结构化的、可搜索的项目开发日记。
注意事项
不适合仅需简单记录文件变更、无需记录决策背景和上下文的超小型或个人速记项目。
常见问题
这个插件会和我的现有 Git 工作流冲突吗?
不会,它无缝集成到你的提交过程中,只是在提交前多了一个引导你填写详细变更信息的步骤,最终生成的日志文件独立于你的代码仓库,不影响 Git 操作本身。
生成的变更日志文件放在哪里?如何搜索?
所有日志文件都存放在项目根目录的 `changelog/` 文件夹下,每次提交生成一个独立的 Markdown 文件。插件会自动生成一个带有关键词索引的 `README.md`,你可以用浏览器的查找功能(Cmd+F/Ctrl+F)快速搜索特定关键词。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/cc-changelog-plugin/raw/index.md 读取 cc-changelog-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/cc-changelog-plugin/raw/index.md(查看排版版本)