AI Agent / 系统课时
打开本地项目
打开本地项目
本课解决 Codex 从错误目录启动、误读其他仓库或把已有改动混入任务的问题。你将从仓库根目录启动 Codex,并在交付任务前确认当前路径、Git 分支和工作区是否干净。
学习目标
- 确认终端当前目录就是目标仓库
- 识别分支、未提交改动和未跟踪文件
- 从正确工作区启动 Codex
启动前确认仓库边界
Codex 会把启动时选择的目录作为主要工作区。若你在仓库上级目录启动,它可能看到多个无关项目;若在子目录启动,又可能缺少根目录中的配置、脚本和 AGENTS.md。最稳妥的做法是先进入仓库根目录,再检查 Git 识别出的顶层路径。
任务开始前还要查看工作区状态。已有改动并不一定要提交,但必须知道哪些文件原本就被修改过,避免把自己的旧改动误认为 Codex 新生成的内容。重要任务建议先建立 Git 检查点。
在仓库根目录启动
下面以一个已经克隆到本机的项目为例。请把 <PATH> 替换为真实路径。
cd <PATH>/my-app
pwd
git rev-parse --show-toplevel
git status --short --branch
codex预期输出
<PATH>/my-app
<PATH>/my-app
## feature/demo
<Codex interactive interface opens in this directory>pwd 与 git rev-parse --show-toplevel 应指向同一个目录。git status --short --branch 第一行显示当前分支;其余行若出现 M、A、D 或 ??,表示工作区并非干净,需要先判断这些改动是否与本次任务有关。实际分支名、路径和界面版本可能不同。
处理已有改动
工作区有改动时,不要直接让 Codex“大范围整理项目”。先用 git diff --stat 了解影响范围,再决定提交、暂存或保留。若这些改动必须保留,可以在第一条任务指令中明确说明“现有改动不是本次任务的一部分,不要覆盖或回退”。
git diff --stat
git diff --name-only预期输出
src/example.ts | <N> +++++-----
<N> file changed, <N> insertions(+), <N> deletions(-)
src/example.ts当输出为空时,表示没有未暂存的已跟踪文件改动;未跟踪文件仍需通过 git status --short 检查。
启动后的首次确认
进入 Codex 后,先用一句短指令核对边界,例如:“只读取当前仓库,告诉我仓库根目录、当前分支和未提交文件,不要修改任何内容。”如果结果与终端检查不一致,应立即退出并从正确目录重新启动,而不是继续补充解释。
首次接触陌生仓库时,先只读确认,再进入修改阶段。目录错误会让后续分析、测试和差异审查全部失去可信基础。