understand
Installation
SKILL.md
understand
把「本次(AI)新生成的代码变更」变成一个可交互的审阅网页:左侧按真实项目布局列出变更文件树,右侧显示所选文件的 diff(高亮、增删与未变更代码明显区分),并在右侧边栏逐段给出相关单位需求与代码解释;解释下方可按需提供「伪代码」「调用树」两个展开式文本视图(参考 show-me skill 的呈现方式)。
始终用中文产出解释与需求。
何时用
- 用户说
/understand、"review 这次改动"、"解释下新写的代码"、"看看这次变更做了啥"。 - 目标是理解 + 审阅当前工作区里尚未吃透的改动(通常是 AI 刚生成的),不是重构或修 bug。
组成
skill 目录下三件套(都在 ~/.claude/skills/understand/):
understand.py— 纯标准库生成器,两个子命令:scan(解析 git diff →data.json+annotations.json骨架)、render(合并注释 →report.html)。template.html— Claude light 主题两栏页面(占位符__UNDERSTAND_PAYLOAD__注入数据),Prism.js 走 CDN 做语法高亮。- 本文件 — 流程说明。