用途:这是面向贡献者的工具,用于将 Claude Code 的版本发布与插件进行对照跟踪。它会拉取 CC 变更日志,提取比上次检查更新的条目,并逐个分析其对插件组件(代理、技能、钩子、配置)的影响。
用法:支持三条命令。运行 /cc-changelog 检查新 CC 版本并分析影响;运行 /cc-changelog --full 重新分析全部版本(忽略上次检查记录);运行 /cc-changelog --set=2.1.85 重置上次检查的版本号,然后重新运行。
执行流程:第一步先执行 bash "${CLAUDE_PROJECT_DIR}/scripts/fetch-cc-changelog.sh" 拉取并提取新条目。若输出以 STATUS: UP_TO_DATE 开头,则报告没有新版本并停止;若为 STATUS: NEW_VERSIONS,则继续处理头部以下的变更内容。--full 使用该脚本加 --all;--set=X 使用该脚本加 --set=X。第二步读取新条目并逐条分类为 BREAKING(可能破坏现有功能,需立即修复)、OPPORTUNITY(可采用的新特性)、RELEVANT FIX(可移除的临时绕行方案)、DEPRECATION(需规划迁移)、INFO(仅记录)。分类时依据 ${CLAUDE_SKILL_DIR}/references/analysis-rules.md 中的规则与插件组件交叉比对。第三步输出结构化报告,按上述五类分组并注明影响文件与具体动作。第四步询问用户是否将上次检查版本更新为最新版;确认后再次运行脚本加 --set={latest},并更新记忆文件 reference_cc_source_internals.md。
限制与原则:分析前必须重新拉取,绝不能分析过期缓存;不得自动更新状态,必须经用户确认;必须结合插件文件映射影响,不能只做摘要;BREAKING 变更视为阻碍项需优先突出;状态文件为版本跟踪的权威来源。