Codex 赋能 AI 一人公司：把注意力带宽变成可编排的执行通道

# AGENTS.md
## 项目
- Python 3.12 + FastAPI，包管理用 uv，禁止 pip install 直接改环境
- 所有新接口必须有 pydantic 入参/出参模型与 pytest 用例

## 纪律
- 改数据库必须走 alembic，禁止手写 DDL
- 提交前运行 `make check`（ruff + mypy + pytest），失败不得提交
- 不引入新依赖，除非在 PR 描述里写明理由与替代方案

## 不要做
- 不要改 `.github/` 与 `deploy/` 下的文件
- 不要重命名公共函数，先开 issue

#!/usr/bin/env bash
set -euo pipefail
# 为缺测试的模块批量生成用例，每个模块独立一次 agent 运行
for f in $(git ls-files 'src/**/*.py' | while read -r f; do
             [ -f "${f%.py}_test.py" ] || echo "$f"; done); do
  codex exec --full-auto \
    "为 $f 生成 pytest 用例，覆盖正常路径与两个边界条件。
     只新建 ${f%.py}_test.py，不改动 $f 本身。运行 pytest 确认通过。" \
    > "logs/gen-$(basename "$f" .py).log" 2>&1 || echo "FAILED: $f"
done

#!/usr/bin/env bash
set -euo pipefail
TASK="$1"
BRANCH="task/$TASK"
DIR="../wt-$TASK"

git worktree add -b "$BRANCH" "$DIR" main
(cd "$DIR" && codex exec --full-auto \
  "读取 TASKS/$TASK.md，按其验收标准实现。
   完成后运行 make check，把改动 git commit -m 'feat: $TASK'。" \
  > "../logs/$TASK.log" 2>&1) &
echo "已派发 $TASK，PID $!"

# scripts/gate.py —— 合并前唯一入口
import subprocess, sys

STEPS = [
    ["uv", "run", "ruff", "check", "."],
    ["uv", "run", "mypy", "src"],
    ["uv", "run", "pytest", "-q"],
]

def run(step: list[str]) -> None:
    r = subprocess.run(step, capture_output=True, text=True)
    if r.returncode != 0:
        print(f"❌ {' '.join(step)}\n{r.stdout}\n{r.stderr}")
        sys.exit(1)

def diff_guard() -> None:
    changed = subprocess.run(
        ["git", "diff", "--name-only", "origin/main"],
        capture_output=True, text=True).stdout.split()
    forbidden = [f for f in changed if f.startswith(("deploy/", ".github/"))]
    if forbidden:
        sys.exit(f"❌ 触碰禁区文件: {forbidden}")

if __name__ == "__main__":
    diff_guard()          # 先查禁区，再看质量
    for s in STEPS:
        run(s)
    print("✅ gate passed")

# 限定范围的一次 exec：只在单文件上下文内工作
codex exec --full-auto --cd src/billing \
  "只修改 invoice.py 中的 calc_tax 函数，其余文件不动"