收藏
0
0
分享
举报
·18 小时前发布·239次阅读

AI 改完代码你还没审,哪些文件会先替你执行?

独立开发商业增长付费用户

用 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 的改动时,会先看这类"打开就执行"的文件吗?还有哪些位置是我漏掉的?

讨论 (0)

0/250

    目录

    关于作者

    心得体会

    TA 还没有留下个人简介

    Solo 独立开发者社区support@solo.xin
    关于社区成长规则SOLO.cc隐私政策用户协议商务合作友情链接订阅更新(RSS)投稿赞助

    © 2023 SOLO · 为独立开发者而生