刚打开一个代码仓库,最容易把“看起来像入口的文件”当成真正入口,或把建议的测试命令误当成项目现成配置。下面用一份虚构的 TypeScript 小项目练习:先让 Codex 梳理文件关系,再回到原文件逐项复核。目标是获取线索,不是让它替你改代码。
准备:选对项目范围,先约定只读
可以在 ChatGPT 桌面应用中选择 Codex 并打开项目文件夹,也可以使用 Codex CLI 或 IDE 扩展。Codex 能读取所选文件夹中的文件,也能修改文件;所以这次明确告诉它只检查、不编辑、不运行命令。若是个人真实项目,先确认选中的是仓库根目录,而不是上层目录或某个子文件夹。
练习仓库名为 `paper-lantern`,文件包括 `AGENTS.md`、`package.json`、`index.html`、`src/main.ts`、`src/app.ts` 和 `tests/app.test.ts`。这些名称和内容都是虚构的。准备时只需把下面提示词中的样本交给 Codex;若改用自己的仓库,则替换成实际文件,别把练习结论套到真实项目上。
先看项目说明,再找入口线索
Codex 会在开始工作前读取 `AGENTS.md` 等项目指引。指引可能来自 Codex 用户目录,也可能来自仓库根目录和更深的目录;更近的指引可能补充或覆盖较早的要求。因此,先让它列出本次判断所依据的指引文件,并区分“项目要求”和“代码证据”。
项目说明能告诉你团队希望怎样工作,却不能单独证明程序从哪里启动。入口要沿实际文件引用追踪:练习中 `index.html` 引用 `src/main.ts`,而 `src/main.ts` 再导入 `src/app.ts`。请让 Codex 把这条链分开写,并注明每个判断来自哪个文件,避免只凭文件名猜测。
从配置中确认测试命令
测试命令优先查 `package.json` 的 `scripts`,不要因为看到了测试目录,就猜一个通用命令。练习样本里有 `"test": "vitest run"`,因此可将 `npm test` 作为项目声明的测试入口;它表达的是配置映射,不表示测试已经运行或通过。
同样,`"build": "tsc -b && vite build"` 对应构建脚本,不是测试命令。真实仓库若没有 `test` 脚本、脚本名称不同,或 Codex 看不到 `package.json`,就把结果写成“未在当前材料中确认”,不要让它补出一个看似合理的命令。
让每个路径都有来处
要求 Codex 将它提到的文件路径逐一列出,并说明路径是从仓库根目录计算,还是由某个文件的相对引用得到。练习里测试文件的 `../src/app` 指向 `src/app.ts`;`index.html` 中的 `/src/main.ts` 则指向应用入口链的下一环。两者作用不同,不能因为都含有 `src` 就混为一谈。
如果回答提到样本中不存在的配置文件、测试文件或入口,先不要照着操作。让它指出原文依据;若给不出,就记为未证实。路径大小写、扩展名和所在目录也要一并对照,尤其在不同系统之间切换时,不要只凭“意思差不多”认定路径有效。
预期结果与原文复核
这份练习的预期结果是:入口链为 `index.html → src/main.ts → src/app.ts`;测试脚本来自 `package.json` 的 `test` 项,对应建议命令 `npm test`;测试文件引用 `../src/app`,可解析到 `src/app.ts`。这只是对虚构材料的静态判断,不代表执行过测试。
至少做一次原文复核:打开 `package.json`,逐字检查 `scripts.test`;再打开 `index.html` 和 `src/main.ts`,确认入口引用与导入内容确实存在。最后检查 `tests/app.test.ts` 的相对路径。若 Codex 的描述与原文不符,以文件内容为准,并要求它基于更正后的材料重答。
可复制的练习提示词
请只检查下面这份虚构项目材料,不要修改文件,也不要运行命令。请分别回答:1. 从 HTML 到应用代码的入口引用链是什么?每一步指出文件和原文依据。2. package.json 声明了什么测试脚本?据此可以建议什么命令?不要声称已运行或通过。3. tests/app.test.ts 引用的相对路径指向哪里?把材料中所有用于结论的路径列出,并区分已确认与未确认。若信息不足,请明确写“未确认”,不要猜测。
虚构文件:
AGENTS.md:本项目改动前先运行 npm test;不要改 docs/。
package.json:{"scripts":{"test":"vitest run","build":"tsc -b && vite build"}}
index.html:<script type="module" src="/src/main.ts"></script>
src/main.ts:import { boot } from './app'; boot();
src/app.ts:export function boot() { return 'ready'; }
tests/app.test.ts:import { boot } from '../src/app';官方参考
核对日期 2026-11-10