用途:编译面向编码智能体上下文构建的项目变更记录。输出到项目根目录的 AGENT_CHANGELOG.md,帮助智能体理解关键决策及理由、识别应避免的废弃模式、把握从过去到现在乃至可能未来的走向,以及发现与现状矛盾的过时文档。
主要能力:分五步工作。一、并行收集来源:git 历史(如 git log --oneline --since="6 months ago" | head -100,以及带 BREAKING、deprecate、remove、migrate 的检索与 git tag -l --sort=-creatordate | head -20)、文档(.claude/plans/、CLAUDE.md、README.md、docs/、CHANGELOG.md)、代码信号(@deprecated 注解,带日期的 TODO/FIXME/HACK 注释,迁移与升级脚本)。二、识别关键事件:架构决策、破坏性变更与迁移、废弃特性、重大依赖变化、目录结构变化、API 变化等;跳过小修复与例行更新。三、交叉核对矛盾,标记出与现状冲突的过时文档。四、写出包含当前状态摘要、检测到的过时信息、反向时间线、废弃模式表与项目轨迹的文件。五、校验合并已有文件、核对日期。
使用方式:在完成大重构或迁移、近期执行了计划、连续发生架构决策、发现文档与代码矛盾、长期中断后重启或初次接触陌生代码库时建议运行。
限制:应优先准确性而非完整性,错误历史比不完整更糟;仅在资料中提供理由时记录理由,条目保持简洁。资料未说明具体安装或调用命令、计费与平台支持。