一段 Prompt，为当前项目安装 Luna 子 Agent 和安全路由规则。
不覆盖现有项目指令，不修改业务代码，不把所有子任务一刀切给 Luna。
Codex 支持项目级自定义 Agent，但只有模型配置还不够：主 Agent 还需要知道什么时候该调用、任务应该切多小、谁负责最终验收。
这个仓库提供两部分：
.codex/agents/luna_worker.toml：定义 Luna worker 的模型、reasoning effort 和执行边界。AGENTS.md托管区块：规定触发词、任务拆分、验收责任和异常处理。
安装过程由 Codex 自己完成。你不需要手动创建隐藏目录或合并 AGENTS.md。
- 打开 INSTALL_PROMPT.md。
- 复制整段 Prompt，交给目标项目里的 Codex。
- 检查 Codex 的写入结果。
- 新建一个 Codex 任务，让项目配置生效。
- 在正常需求后加一句：
这个明确模块交给 Luna，验收仍以现有测试通过为准。
也可以只要求调用子 Agent：
这次必须调用子 Agent。
主 Agent 仍应先切出边界明确、可独立验收的任务，而不是把整个复杂项目直接转交给 Luna。
| 交给 Luna | 留给主 Agent / 更强模型 |
|---|---|
| 范围窄、要求明确的模块 | 开放式探索和跨模块架构决策 |
| 定向搜索、日志整理 | 高风险写入 |
| 已有测试约束的实现 | 模糊、长流程的持续推进 |
| 可独立运行的测试 | 最终整合与验收 |
用户需求
│
▼
主 Agent：拆分范围 + 写清验收条件
│
├── 明确、窄、可测试 ──► Luna worker ──► 文件 + 测试证据
│ │
└──────────────────────────────────────┘
主 Agent：复核、整合、最终交付
your-project/
├── .codex/
│ └── agents/
│ └── luna_worker.toml
└── AGENTS.md
模板可以在这里直接查看：
同一 Prompt、同一主模型、同一验收条件下的一次 A/B 实验。A 组仅将边界清楚的算法模块委派给 Luna；B 组不调用子 Agent。两组均通过测试、构建和浏览器验收。
这是单次、特定任务边界内的实验，不代表 Luna 适合所有子 Agent 工作。
不要把角色名、界面昵称或 Agent 自述当成路由证据。
如果当前 Codex 环境能够显示运行时元数据，应检查：
thread_source = subagent
agent_role = luna_worker
model = gpt-5.6-luna
如果实际模型不是 gpt-5.6-luna，停止并报告路由异常，不要把这次调用当成有效的 Luna 实验。
- 关键词路由来自项目
AGENTS.md指令，不是不可绕过的底层 hook。 - 安装 Prompt 已按“只修改两个目标、保留现有 AGENTS 内容、冲突时停止”的策略设计。
- 模型可用性取决于你的 OpenAI / Codex 账号和当前产品权限。
- Luna 不是所有子 Agent 任务的默认最优解。这里解决的是明确、窄、可测试任务的受控分工。
- 修改配置后需要新建任务；已有任务可能继续使用启动时加载的配置。