用途:帮助用户在不逐行阅读 diff 的情况下理解一次代码改动,从代码原因(为何这样写)、系统原因(为何这个模块、边界与数据流)和架构原因(为何选此方案、对代码库的长期约束)三个视角组织讲解与提问。
主要能力:会话按轮次进行,先确定 diff 的固定基准点,再收集改动原因并标注来源(来自本次会话,或依据提交信息、issue、spec、术语表、ADR 等推断)。随后按概念把改动切成若干单元,每单元一个原因,按架构重要性排序,默认最多五段,其余折叠并列出。每段给出三层原因、关键代码片段(最多约 20 行,带 path:line)、一行权衡和两到三个问题,其中包含开放式问题与等字数的多选题。用户回答后给出 Right、Partly 或 Off 的判定,并附一段锚定到具体 path:line 的说明。
使用方式:会话提供四种动作——skip(跳过)、deeper(深入)、next(接受并继续)、explain(直接讲解不测验)。结束时汇总跨段权衡、记录回答薄弱项及需重读的位置,并给出三到五句可转述给同事的总结。
限制:不向磁盘写入任何内容;推断出的原因只能作为确认提示,不能当作事实提问;若提交 diff 为空且工作区干净则直接停止;疑似缺陷仅标注 Not reviewed 并指向 /code-review,不做审查。具体安装或调用命令资料未提供。