> ## Content Index
> Fetch the complete content index at: https://lucent.blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# AI 代码越写越快，代码审查速度也需要跟上
- URL: https://lucent.blog/show-me-skill-share/
- Published: 2026-09-04T02:05:46.000Z
- Updated: 2026-09-04T02:34:27.000Z
- Author: Lucent

团队引入 Claude Code 和 Codex 之后，代码产出确实变快了，初级工程师半天就能提交上千行代码。

但写得快不代表质量稳，审查反而成了最大的瓶颈。面对动辄几百上千行的新增代码，如果没人能快速看懂、理清逻辑，积压的技术隐患很快就会变成严重的返工成本。

### **传统审查已过时**

传统的代码审查依赖逐行对比（git diff）。

人类手写代码时，思维通常是局部推进的，逐行查看文件的增删行基本能跟上作者的修改思路。

但大模型生成的代码是整块成型输出的。面对屏幕上大片绿色新增代码，审查人很难靠肉眼把散在十几个文件里的逻辑在脑中还原成调用链与数据流。

审查人真正需要第一时间搞清的，是这三个关键问题：

1. 本次提交改动了哪些核心调用链路。
2. 新代码有没有破坏现有的模块边界。
3. 组件间的数据流转是否符合最初的设计规范。

**HumanLayer 开源的 show-me skill，解决的就是这种代码不易看懂的问题。**

### **什么是 show-me**

show-me 是一个面向 AI Coding Agent 的行为约束规范。

它的核心规则只有两句话：

“Help the user understand the current topic visually. Skip the preamble and keep prose brief. Pick the smallest view that makes the key point clear.”

意思很简单：去掉所有开场客套，文字压到最简，只用能讲清逻辑的最小视图呈现内容。

![28587ab2e4282e9ba78b89968d96068c](https://obj.lemonc.cc/files/2026/09/04/094440/28587ab2e4282e9ba78b89968d96068c.png)

在代码审查场景中，show-me 主要通过四种结构化视图来展示变动：

#### **1\. 紧凑调用树（Call Tree）**

审查 PR 时，不用先啃几百行业务实现，直接要求 AI 输出关键执行链路的调用树。

每层缩进代表一级调用。审查人扫一眼就能确认关键分支，比如下单流程到底有没有经过风控和库存校验。

#### **2\. 浅层文件树（Shallow File Tree）**

AI 在处理新需求时经常会乱放文件。show-me 要求在提交变动时输出带职责说明的浅层文件树：

```
src/
├── domain/order/       # 领域实体与业务规则
├── infrastructure/     # 数据库与外部接口实现
└── interfaces/api/     # 控制器路由与参数解析
```

如果 AI 在 domain 目录下引入了 infrastructure 的依赖，文件职责树会直接暴露违规引用。

#### **3\. Mermaid 时序图**

遇到涉及多个服务或异步消息的复杂流程，代码往往分布在多个模块。show-me 用 Mermaid 描述交互时序：

![image-20260904095555928](https://obj.lemonc.cc/files/2026/09/04/095556/image-20260904095555928.png)

审查人不用通读底层细节，对着时序图就能直接核对数据流向与设计方案是否吻合。

#### **4\. 语义差异（Semantic Diff）**

普通的 git diff 夹杂了大量空行、注释和格式调整。show-me 提取真正影响业务状态的变化：

```diff
 on(save)
-  directCommit()
+  if isDirtyState
+    validateSchema()
+    batchCommit()
```

这种对比只展示业务控制流的变化，剔除了无关的格式干扰。

### **在 Claude Code 和 Codex 中使用 show-me**

把规范文件纳入 git 版本管理，团队成员拉取代码后即可直接生效。

使用 Claude Code： 在项目根目录创建文件：`.claude/skills/show-me/SKILL.md`

使用 Codex 或通用 Agent 框架： 在项目根目录创建文件：`.codex/skills/show-me/SKILL.md` 或 `.agents/skills/show-me/SKILL.md`

也可以使用命令行工具直接安装到全局环境：

```shell
npx skills add humanlayer/skills --skill show-me -g
```

### **实践建议**

代码生成速度提升之后，工程质量的把控点必然会转移到审查环节。与其靠人工在冗长的 diff 里排查，不如让 AI 在提交前先交付调用树、文件职责和时序图。把变动逻辑直观呈现出来，审查才能真正跟上 AI 的产出速度。