docs: preserve particle task history and RDC workflow rules

AGENTS.md

@@ -89,3 +89,66 @@ Codex 的核心角色是“实现者”，不作为其自身修改结果的唯
 每一阶段必须有 `docs/50_Step记录/STEP-xxx_*.md`。完成报告固定写入 `docs/报告/STEP-xxx_<主题>_Codex完成报告_vN.md`（仅在任务要求 Codex 完成报告时）。
 
 修改结束必须按当前构建规范验证、更新 Step、追加 `粒子开发记录.md`，并明确所有未完成/阻塞。Git 提交必须 scoped，禁止把既有无关 dirty/untracked 一并提交。
+## 8. Codex 写代码，RDC 执行编译 / 测试
+
+本项目固定采用以下闭环，除非用户在当前任务中明确另行授权：
+
+1. **Codex 负责实现与修复。**
+   - 读取当前任务、设计、源码与错误信息；
+   - 修改代码、测试代码、构建脚本和任务要求的文档；
+   - 分析 RDC 返回的编译、链接、测试、codegen、打包失败；
+   - 根据真实错误继续修复代码。
+
+2. **RDC / 普通 Terminal 负责实际编译与验证。**
+   - CMake / Ninja / Bazel 编译；
+   - C++ / OpenGL / Metal 定向测试；
+   - codegen、链接、打包、artifact 检查；
+   - 其他耗时构建或机械性验证。
+   Codex 不应自行启动、等待或轮询这些长时间命令。
+
+3. **固定闭环：**
+   `Codex 写代码 → Codex 停止并给出精确验证命令 → RDC 执行 → RDC 返回结果 → 若失败，Codex 分析并修复 → RDC 再验证`。
+
+4. **失败日志只回传必要信息。**
+   - RDC 保留完整 stdout/stderr；
+   - 成功时只返回 exit code、耗时和必要摘要；
+   - 失败时优先返回首个真实 error、相关 target、前后必要上下文和日志路径；
+   - 不把完整大型 build log 反复送入 Codex。
+
+5. **Codex 禁止行为。**
+   - 未经用户明确授权，不得自行执行长时间编译、链接、codegen、打包或大型测试；
+   - 不得创建 background terminal 等待 build；
+   - 不得高频轮询构建状态；
+   - 不得为了等待编译而自行切换模型或启动第二个 Codex 实例；
+   - 不得把“编译未完成”当作理由持续占用高能力模型。
+
+6. **RDC 发现问题后的处理。**
+   - RDC 可以直接处理范围明确、风险低、原因清楚的小问题，包括：
+     - 构建命令、CMake/Bazel 配置、链接配置、平台条件、测试条件等小型工程问题；
+     - 单文件或少量文件内、无需重新设计架构的小型源码修正；
+     - 明确的编译错误、声明/定义不一致、include/宏条件、简单 ABI/平台兼容问题；
+     - 不改变既定业务语义和总体架构的局部修复。
+   - RDC 修完后应立即重新编译/测试验证，不必为了这类小问题启动 Codex。
+   - 以下情况才交给 Codex：
+     - 大规模逻辑修改；
+     - 跨模块或跨层重构；
+     - renderer / runtime / API 设计需要重新判断；
+     - 需要新增较完整功能或大量代码；
+     - 用户明确指定“这是 Codex 代码任务”。
+   - 一旦 RDC 判断修复范围开始扩大、需要重新设计或无法通过少量明确修改解决，应停止继续扩改，把错误证据和现状交给 Codex。
+
+7. **用户可见性。**
+   - 本项目未经用户明确授权，不得使用后台/headless Codex 执行任务；
+   - Codex 默认运行在用户可见的 Terminal/TUI 中；
+   - 当前 Mac 上如需启动或恢复 Codex，必须优先使用现有 GNU Screen 会话 `7445.codex`；
+   - 不得另起隐藏的 Codex 进程或新的不可见会话，除非用户明确授权；
+   - 用户应能够通过该 screen 会话直接看到 Codex 的输入、输出和当前状态。
+
+8. **任务书冲突处理。**
+   - 若旧任务书写有“Codex 必须执行编译/测试”，但用户未在当前任务明确重新授权，则以本节为准：
+     Codex 只准备代码与验证命令，RDC 负责实际执行。
+   - 只有用户在当前任务中明确要求“由 Codex 执行某项编译/测试”时，Codex 才可执行该项。
+
+核心原则：
+
+> Codex 负责写和改；RDC 负责跑和验；RDC 报错，再交回 Codex 修。