用途:把本次(通常是 AI 刚生成的)代码变更变成可交互的审阅网页,帮助理解与审阅当前工作区尚未吃透的改动,而非重构或修 bug。触发场景包括 /understand、"review 这次改动"、"解释下新写的代码"。
主要能力:左侧按真实项目布局列出变更文件树,右侧显示所选文件 diff(高亮、增删与未变更代码区分),边栏逐段给出相关单位需求与代码解释;解释下方可按需展开「伪代码」「调用树」文本视图。解释与需求始终用中文产出。
使用方式:skill 目录含 understand.py(纯标准库,子命令 scan 与 render)、template.html(Claude light 主题两栏页面,占位符 UNDERSTAND_PAYLOAD 注入数据,Prism.js 走 CDN)和流程说明文件。在用户当前工作目录执行: python3 "$SKILL_DIR/understand.py" scan 默认基线为当前分支与主分支(origin/main→main→master)的 merge-base,可用 --base <ref> 指定范围,默认输出到 .understand/,可用 --out <dir> 更改;覆盖已提交、已暂存、未暂存与未跟踪新文件。随后通读改动并编辑 .understand/annotations.json(含 title、summary、files[].path、annotations 的 side、start、end、requirement、explanation、pseudocode、callTree、inferred 字段),再执行: python3 "$SKILL_DIR/understand.py" render open .understand/report.html(Linux 用 xdg-open)。
适用场景:审阅 AI 生成的新代码、理解分支或工作区改动、为关键逻辑补充需求与解释。
限制:只读代码并写 .understand/ 下产物,不改动业务代码;行号须对齐 data.json 的真实行号,填错会导致定位无反应;无变更时如实告知;.understand/ 为产物目录,建议 git clean 或加入 .gitignore。其余细节暂未提供。