技能介绍

你隔半年再打开项目时缺的是什么

Git log 只会告诉你「哪一行、哪天改了」，PR 里常见的「重构模块」「优化性能」往往没有留下放弃的选项、当时的约束和真实根因。结果是：奇怪的架构、记不起用途的模块，没人能回答「当时为什么这样做」。进化日志要补的是这层项目叙事——不是替代版本控制，而是记录 git 记不下的「为什么」。

技能如何工作

技能把值得回顾的时刻收成六类事件（E1 决策、E2 架构变更、E3 技术选型、E4 踩坑、E5 灵感、E6 里程碑），写入项目目录下的 evolution-log.json，并支持多项目切换。

触发：对话里在「信号词 + 决策感」同时成立时最多轻问一次是否记录；也可说「记录一下」或一句话极简条目。整轮对话自动询问不超过 3 次，你说「不用」或「先别记录」即停。
写法铁律：记为什么、具体数字与上下文；用 related_events 串成进化树；决策被推翻时新增推翻记录，不删旧条。
回溯：按时间线、事件类型、标签、关键词或关联事件查询，并可生成周期性的进化报告。

适用边界

常规改 bug、无决策空间的执行、已回滚的试验、纯 patch 升级等按反过滤规则不必记——三个月后帮不上你的就不该进日志。技能不能从 git 自动还原历史理由，也不能替你回忆从未说出口的决策；它是记录与检索，不是评判当初对错。与 git log 互补：一个记「变了什么」，一个记「为何变」。