SuperAPI AI 工具集

explain-changes

前端与建站

查看项目

更新于 10-15 21:47

技能介绍

用途:为当前分支上相对默认分支的全部改动(含已提交与未提交)生成一份 HTML 说明页并在浏览器中打开,目标是让读者理解改动到足以评审的程度。

主要能力:用 git merge-base、git diff、git status 等确定改动范围;阅读 diff 之外的上下文(周边文件、父类、调用点)以解释真实行为;展示真实代码片段而非虚构示例;解释设计取舍与被否决的替代方案;在合适时用 Mermaid 或内联 SVG 画图;指出授权、金额、数据丢失、迁移、多租户等需重点审查之处,以及未同步更新的调用点、测试和文档;发现解释不通之处时如实说明,不修复、不批准、不做系统性找 bug。

使用方式:页面写到仓库之外,路径为 ~/.claude/explanations/<repo>-<branch>-<YYYYMMDD-HHMMSS>.html,基于 references/page-template.html 构建,代码块用 <code class="language-php"> 形式交由 highlight.js 着色,Mermaid 源码放在 <pre class="mermaid">,并排内容用 <div class="cols">。若分支已推送,用提交 sha 生成永久链接;未推送则说明并使用普通路径。最后执行 mkdir -p ~/.claude/explanations 与 open "$OUTPUT" 打开并打印路径。

适用场景:需要向同事或评审者解释一个分支的改动时。

限制:不修复、不批准代码,也不做系统性 bug 排查;不把页面写入工作树;不输出未确认可解析的链接;避免使用破折号作标点。资料未提供收费、价格、平台支持等信息。