03-准备项目与工作区

pwd
ls -la
git rev-parse --show-toplevel
git status --short --branch

Get-Location
Get-ChildItem -Force
git rev-parse --show-toplevel
git status --short --branch

/work/demo/shop
## main...origin/main

find . -maxdepth 2 -type f \( -name 'README*' -o -name 'package.json' -o -name 'pyproject.toml' -o -name 'go.mod' \) -print

Get-ChildItem -Recurse -Depth 2 -File README*,package.json,pyproject.toml,go.mod

mkdir -p ~/code
cd ~/code
git clone https://github.com/example/shop.git shop
cd shop
git remote -v
git status --short --branch

origin  https://github.com/example/shop.git (fetch)
origin  https://github.com/example/shop.git (push)
## main...origin/main

git clone git@github.com:example/shop.git shop

ls -la
less README.md
git log -5 --oneline
git branch --all

Get-Content README.md -TotalCount 120

codex --help
codex exec --help

codex --sandbox read-only

/permissions

请只读取项目根目录的说明文件和 Git 状态，概括项目结构、可用测试命令和可能的敏感文件；不要修改任何文件，不要联网。

git status --short

git switch --show-current
git status --short --branch
git switch -c codex/prepare-workspace

git checkout -b codex/prepare-workspace

Switched to a new branch 'codex/prepare-workspace'

git status --short
git diff --check
git add -A
git commit -m "chore: save state before Codex task"

git status --short --branch
git log -1 --oneline

git diff > ../before-codex.patch
git diff --cached > ../before-codex-staged.patch

git worktree add ../shop-codex-feature -b codex/feature main
git worktree list

git worktree remove ../shop-codex-feature
git worktree prune

~/.codex/AGENTS.md                 全局个人规则
~/code/shop/AGENTS.md              仓库根规则
~/code/shop/services/AGENTS.md     子目录规则
~/code/shop/services/api/AGENTS.md 当前目录规则

find .. -name 'AGENTS.md' -o -name 'AGENTS.override.md'

Get-ChildItem .. -Filter AGENTS.md -Recurse
Get-ChildItem .. -Filter AGENTS.override.md -Recurse

# shop

## 常用命令
- 安装依赖：`pnpm install`
- 检查：`pnpm lint`
- 测试：`pnpm test`

## 规则
- 修改 API 后必须更新对应测试。
- 不修改 `migrations/` 中已经发布的文件。
- 新增依赖、访问外部服务或推送远端前先询问。

请总结本次生效的 AGENTS.md 规则，并列出你找到的规则文件路径。只总结，不修改文件。

项目根/.codex/       项目相关的可共享配置或本地环境设置
~/.codex/             当前用户的 Codex 数据、全局规则和 config.toml

find .codex -maxdepth 2 -type f -print 2>/dev/null

~/.codex/config.toml

C:\Users\你的用户名\.codex\config.toml

project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 65536

cp ~/.codex/config.toml ~/.codex/config.toml.backup

mkdir -p ~/codex-sandbox-demo
cd ~/codex-sandbox-demo
git init
printf 'hello\n' > README.md
git add README.md
git commit -m "initial demo"
codex --sandbox read-only

请创建 check.txt，写入 sandbox test。先说明你需要的权限，不要执行其他命令。

test ! -e check.txt && printf 'check.txt was not created\n'

git status --short
git diff -- README.md
ls -la

printf 'directory: '; pwd
printf 'root: '; git rev-parse --show-toplevel
git switch --show-current
git status --short --branch
git diff --stat
git diff --check
git log -1 --oneline
find . -maxdepth 2 -name 'AGENTS*' -print

mkdir -p ~/codex-practice
cd ~/codex-practice
printf 'def add(a, b):\n    return a + b\n' > main.py
git init
git add main.py
git commit -m "initial practice project"
git status --short --branch

请解释 main.py，并先列出你会如何验证修改结果。不要修改文件。

给 add 增加类型注解，只修改 main.py，不要新增依赖，不要运行联网命令。完成后说明修改原因。

git diff -- main.py
git diff --check
python -m py_compile main.py
git status --short

git status --short
git diff --stat
git diff

git restore --source=HEAD -- main.py

git restore .
git clean -nd

git log --oneline --decorate -5
git show --stat HEAD

git revert <commit-id>

git diff > ../codex-failed-change.patch
git status --short > ../codex-failed-status.txt

选项目 -> 确认路径 -> 检查 AGENTS.md -> 选择沙箱 -> 切任务分支
-> 建 Git 检查点 -> 先只读分析 -> 小范围修改 -> 看 diff 和测试
-> 满意后提交，不满意就按证据回滚