用途:为编码智能体编译项目演进记录,输出到项目根目录的 AGENT_CHANGELOG.md,帮助智能体理解关键决策及其理由、识别应避免的弃用模式、把握项目发展轨迹,并发现与现状矛盾的过时文档。
主要能力:并行收集 git 历史、文档(.claude/plans/、CLAUDE.md、README.md、docs/、CHANGELOG.md)与代码信号(@deprecated 注解、TODO/FIXME/HACK 注释、迁移与升级脚本);筛选架构决策、破坏性变更与迁移、弃用功能、重大依赖变更、目录结构与 API 变更等关键事件;交叉比对文档与事件,标记过时信息;输出含当前状态摘要、过时信息检测表、时间线、弃用模式表与轨迹预测的结构化文件。
使用方式:在需要更新变更日志、编译历史或梳理项目演进时触发。示例命令:git log --oneline --since="6 months ago" | head -100;git log --all --oneline --grep="BREAKING" --grep="deprecate" --grep="remove" --grep="migrate" -i;git tag -l --sort=-creatordate | head -20。写入后需与已有 AGENT_CHANGELOG.md 合并而非重复,并核对日期。
适用场景:重大重构或迁移完成后、.claude/plans/ 中的计划刚被执行、短时间内发生多次架构决策、发现文档与代码矛盾、长期中断后重新开始工作、或加入不熟悉的代码库时。
限制:资料未提供具体安装方式、收费模式与平台支持信息;准确性优先于完整性,错误历史比不完整更糟;条目应简洁,仅作参考材料。