---
name: "codex-delegation"
description: "派活给Codex在服务器上干活。当需要Codex修改服务器文件、查bug、跑脚本时调用。要点：给足权限，直接SSH，写报告存档，不监控"
---

# Codex 派活指南

## 基本原则

1. **直接 SSH** — 不给Codex生成补丁包，让它直接 SSH 到目标服务器改
2. **给足权限** — 必须加 `--sandbox danger-full-access` 否则 SSH 不通
3. **不监控** — 派完就走，不盯着 Codex 输出看
4. **写报告** — Codex 必须把变更写一份文档到仓库，我来审
5. **指令要完整清晰** — 一次性把所有需求写清楚

## 标准工作流

```
我 ──派活(详细任务清单)──→ Codex
                          Codex SSH进目标服务器干活
                          Codex 写报告到 /root/codex-reports/{任务名}-{日期}.md
我 ──读报告验收──→ 通过/有问题
                          ↓ 有问题
                          补活 或 自行修复
```

## 任务指令写法

必须包含以下要素：

### 1. 目标服务器
```
SSH到4号(ssh root@62.234.10.150)，...
```

### 2. 具体操作（任务清单）
逐条列清楚：
```
完成以下任务：
1. 检查 /data/xinan-fashion/backend/routers/orders.py 的 total_amount 字段，没有_cent/_yuan/_text就加上
2. 检查前端 account/page.tsx，total_amount 显示加 /100
3. 验证前台显示是否正确
```

### 3. 改完后重启服务
```
每改完一个模块就重启：pm2 restart xinan-backend
全部改完后再次重启确保生效。
```

### 4. 写报告到指定路径
```
所有这些都做完后，写一份报告到 /root/codex-reports/{任务名}-{日期}.md。
内容必须包含：
- 改了哪些文件（路径+具体修改内容）
- 改之前的 Bug 原因
- 验证结果（怎么验证的，结果对不对）
- 有没有发现其他新问题
```

## 检查验收

Codex 报告写好后，我直接拿报告来验收：

```bash
# 看最新的报告
ssh 5hao 'ls -t /root/codex-reports/*.md | head -5'
ssh 5hao 'cat /root/codex-reports/最新报告.md'
```

验收后：
- **通过** → 记录到项目日志
- **有问题** → 派新活让 Codex 继续修，告诉他"报告里第 X 条没通过，重新做"

## 标准命令结构

```bash
ssh 5hao "echo '任务描述...' | codex exec --skip-git-repo-check --sandbox danger-full-access -"
```

## 完整示例

### 修价格字段
```bash
ssh 5hao "echo '
SSH到4号(ssh root@62.234.10.150)，完成以下任务：

1. 检查 /data/xinan-fashion/backend/routers/orders.py 的 total_amount 字段
   - 没有 _cent/_yuan/_text 字段就加上
   - 确保 order.items 里的 price 也有兼容字段
2. 检查 /data/xinan-fashion/backend/routers/cart.py 的购物车价格字段
3. 检查前端 /data/xinan-fashion/src/app/account/page.tsx
   - total_amount 显示要用 total_amount_text 或自己 /100
4. 检查前端 /data/xinan-fashion/src/app/orders/[id]/page.tsx
   - 所有价格显示都要 /100

每改完一个重启：pm2 restart xinan-backend

全部做完后写报告到 /root/codex-reports/fix-price-fields-$(date +%Y%m%d).md
报告内容：
- 改了哪些文件
- 每个文件改了什么
- 验证结果（curl 验证 API 返回，截取关键字段）
- 发现的其他问题
' | codex exec --skip-git-repo-check --sandbox danger-full-access -"
```

### 查日志
```bash
ssh 5hao "echo '
SSH到4号，查看 /data/xinan-fashion/backend/logs/error.log 最后100行，
找出最近的错误原因。重点关注支付相关错误。

写报告到 /root/codex-reports/log-check-$(date +%Y%m%d).md
' | codex exec --skip-git-repo-check --sandbox danger-full-access -"
```

## 不要做的

- ❌ 生成补丁包让用户手动复制
- ❌ 派完活还盯着 Codex 输出看
- ❌ 分多次派活（把需求一次性说完）
- ❌ 帮 Codex 擦屁股（它没做好的，重新派活让它自己修）

## 注意事项

- Codex 在 5号服务器上，通过 SSH 访问所有其他服务器
- 5号本身可以直连 4号: `ssh root@62.234.10.150`
- 不加 `--sandbox danger-full-access` 的话 bubblewrap 沙箱会阻断 SSH
- 本地文件还是要自己改，Codex 只负责服务器端操作
- Codex 报告路径 `/root/codex-reports/` 需要提前建好