用途:cyxj-remotion-evolve 是 Remotion 工作台的“活文档”机制,目标是把每次制作或对话中学到的东西沉淀为下次的起点,让规则文档随实践自动进化,而不是靠人记得改。它不负责复盘或 QA,也不替代官方核查与硬规则,只负责把规则本身改对、改全、放对地方。
触发方式:手动触发为用户说“进化/更新文档/回写规则/把这次学到的写进规则”;自动触发由收工“文档进化闸”hook(.claude/hooks/evolve-on-stop.mjs,Stop 时机,搭档 record-evolve-touch.mjs 记录本轮改动)在检测到本轮动过镜头或出片代码而规则文档未动时拦截提醒;对话中出现纠正、新决策、新手法、旧规则被推翻时也可主动提议。
主要能力与铁律:绝不静默改文档,先出 diff 提案、按文件分组、说明理由,用户批准才写;单一真源,每条事实只在一个真源写全,别处只放指针,禁止复制重复;CLAUDE.md 是路由器而非仓库,具体规则进对应真源文件;视觉值改 kit/theme.ts 而非组件内联硬编码;规则移动时同步改掉所有指向它的路由行。
执行分工:主对话只采集信号(从会话对话与 git diff/log 压缩成简报)并按铁律出提案、拿批准;批准后派 general-purpose 子代理读真源、查重、回写、记沿革并返回 diff 摘要。批准环节不可下放给子代理。
路由链地图(锚点为仓库根):CLAUDE.md 为根路由与三层真源索引;kit/CLAUDE.md 为共享层索引与组件晋升规则;template/CLAUDE.md 为出片层禁区;docs/HARD_RULES.md 为工程红线唯一真源。
进化四步:采集信号(纠正、新决策、新手法、旧规则被推翻、创造与复用事件);分类路由到唯一真源;写前做一致性检查(查重、处理移动、验证指针连通);出提案、批准后写入。判不准放哪应询问用户。设计说明书、动效笔记、引擎能力手册等私有沉淀本仓不含,需按同样机制自建。限制:具体安装与命令资料未提供。