用 AI agent 写代码,审查时大家盯的通常是业务逻辑:函数写得对不对,测试有没有覆盖到。但 agent 的改动里还有一类东西,不用你"运行程序"就会被执行:你在编辑器里打开文件夹、装依赖、下一次让 agent 干活、敲 git commit 的时候,它们就跑起来了。
下面按"什么时候会被执行"分成四类,每一类给出要看的文件和能直接用的命令。内容都是通用的 Git 和编辑器知识,跟你用哪个 agent 没关系。
0. 先把这类文件从改动里挑出来
# 已跟踪文件的改动 + 新建的未跟踪文件
{ git diff --name-only HEAD; git ls-files --others --exclude-standard; } \
| grep -E '(^|/)(\.vscode/|\.cursor/|\.claude/|\.husky/|\.githooks/|\.cargo/|\.envrc$|\.npmrc$|package\.json$|build\.rs$|go\.mod$|Makefile$|rust-analyzer\.toml$|\.pre-commit-config\.yaml$|\.gitattributes$)'
git diff 不显示新建的文件,所以要加上 git ls-files --others。如果这一步有输出,就先读这些文件,再去读业务代码。
另外记得看一眼被 .gitignore 忽略的文件,有些本地配置默认就不进 Git:
git status --short --ignored
1. 打开文件夹的时候:编辑器和语言服务器
.vscode/tasks.json 里的自动任务。 任务可以设置 "runOptions": { "runOn": "folderOpen" },打开文件夹就运行。VS Code 文档对 task.allowAutomaticTasks 的说明是:默认值是 off,第一次遇到时会问你一次 Allow 还是 Disallow;未受信任的工作区里,自动任务永远不运行。要留意的是:如果你以前对这个工作区选过 Allow,后来 tasks.json 里的命令被改了,下次打开时跑的就是新命令。所以 diff 里出现 tasks.json,打开之前先读。
.vscode/settings.json 里能指定命令或可执行文件的设置。 比如 rust-analyzer 的 rust-analyzer.cargo.buildScripts.overrideCommand,文档的说明是"覆盖 rust-analyzer 用来运行 build script、编译过程宏的命令"。各种语言扩展里的 *.path、解释器路径也属于这一类。VS Code 的受限模式(Restricted Mode)就是为这类设置准备的,工作区一旦被信任,这些设置就直接生效。
rust-analyzer 默认会运行项目代码。 cargo.buildScripts.enable 和 procMacro.enable 默认是开的(文档写明 procMacro 开着就意味着 build script 也开着),所以打开一个 Cargo 项目,就会编译并运行 build.rs、加载过程宏。checkOnSave 会在保存时跑 cargo check,而 cargo check 同样会编译并运行 build script 和过程宏。如果你只是想先读一遍 agent 刚写的、还没审过的 Rust 代码,可以在审查用的用户设置里先关掉:
{
"rust-analyzer.cargo.buildScripts.enable": false,
"rust-analyzer.procMacro.enable": false,
"rust-analyzer.checkOnSave": false
}
代价是:OUT_DIR 里生成的代码分析不到,derive 和属性宏生成的条目跳不到定义,诊断也会少一些。读完、确认没问题,再打开。
.envrc。 direnv 的设计值得参考:.envrc 内容一变,direnv 就拒绝加载,直到你重新 direnv allow。所以看到"is blocked"的提示时,别顺手 allow,先 git diff HEAD -- .envrc。
2. 装依赖的时候:package.json、go.mod
npm 的生命周期脚本。 npm 文档写得很清楚:不带参数的 npm install 会依次运行项目里的 preinstall、install、postinstall、prepare 等脚本。如果根目录有 binding.gyp、又没写 install 脚本,npm 会默认执行 node-gyp rebuild。所以:
git diff HEAD -- package.json .npmrc # 重点看 "scripts" 有没有新增或改动
git diff HEAD -- package-lock.json | grep '"resolved"' # 有没有不是 registry 的 tarball 地址
npm install --ignore-scripts # 拿不准时先这样装,读完脚本再跑
go.mod 里的 go / toolchain 行。 Go 默认 GOTOOLCHAIN=auto:go.mod 要求的版本比本机新,go 命令会自动下载对应的工具链再运行(官方发布、经过校验和验证)。这通常没什么问题,但你应该知道有这么一条链路:"编辑器调用 go → 下载并运行另一个版本的工具链"。agent 改了这两行,值得问一句为什么。
3. 下一次让 agent 干活的时候:agent 自己的配置
hooks。 Claude Code 的 hooks 写在 .claude/settings.json 里(这个文件可以提交进仓库),会在工具调用前后等事件上执行 shell 命令;.claude/settings.local.json 里也能写 hooks,但它通常被 gitignore,所以 git status 默认看不到,要用上面的 --ignored 才能看到。Cursor 的项目级 hooks 放在项目根目录的 .cursor/hooks.json。
规则文件。 AGENTS.md、CLAUDE.md、.cursor/rules/ 这些文件本身不执行,但会改变下一次 agent 怎么干活。agent 改了它们,就当作改了"给下一个 agent 的指令"来审:新加的规则是不是你同意的。
4. 提交的时候:.git 目录里的东西,diff 永远看不到
agent 只要有 shell 权限,就能写 .git/hooks/pre-commit,或者改 .git/config。这些都在 .git/ 里面,git status 和 git diff 都不会显示。提交之前查一下:
ls "$(git rev-parse --git-common-dir)/hooks" | grep -v '\.sample$' # 有没有真正启用的 hook
git config --show-origin --get-all core.hooksPath # hook 目录是不是被改到别处了
git config --local --list --show-origin \
| grep -iE 'hookspath|fsmonitor|sshcommand|textconv|filter\.|\.cmd'
用 --git-common-dir 是因为 worktree 共用同一个仓库的 hooks 目录,在 worktree 里查 .git/hooks 会找错地方。最后一条列出的几项配置都能让 Git 执行一条命令:core.fsmonitor 会在 git status 时运行,filter.* 配合 .gitattributes 会在 checkout 和 add 时运行。常见的 husky 也是在 prepare 脚本里设置 core.hooksPath 的,所以仓库里的 .husky/、.githooks/、.pre-commit-config.yaml 也要和代码一起读。
一张顺序表
| 什么时候执行 | 先看什么 |
|---|---|
| 打开文件夹 | .vscode/tasks.json、.vscode/settings.json、rust-analyzer 设置、.envrc |
| 装依赖 | package.json 的 scripts、.npmrc、lockfile 的 resolved、go.mod |
| 下一次 agent 运行 | .claude/settings*.json、.cursor/hooks.json、规则文件 |
| 提交 | .git/hooks、core.hooksPath、.git/config 里能执行命令的配置 |
这些文件通常只占 diff 的几行,却决定了你的机器上接下来会跑什么。先查它们,再去读业务逻辑。
如果你想在 Mac 上先把 AI 的改动读懂、再决定要不要信任它:Yenpo 是一个免费的 Mac 应用(Freeware),用来在你和 AI 一起写项目时,读懂和审查 AI 写的代码。它打开本地 Git 仓库,看 commit、分支(从分叉点比,或者直接比两端)和未提交的改动,包括未跟踪的文件;代码导航用的是你这台机器上的 language server,Rust 项目默认不运行 build.rs 和过程宏。AI Reader 是可选的,用你自己的 AI 服务商。AI Reader 默认只读,Allow Edits 只对你发给 AI Reader 的下一条消息生效,之后自动切回只读。它不和 Claude Code、Codex、Cursor、GitHub 集成,只是打开本地 Git 仓库。https://yenpo.app/?utm_source=solo&utm_medium=article&utm_campaign=test_post
披露:Yenpo 是我做的。
你们审 agent 的改动时,会先看这类"打开就执行"的文件吗?还有哪些位置是我漏掉的?