1

~/.codex/agents/luna-worker.toml

1

.codex/agents/luna-worker.toml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

name = "luna_worker"
description = "负责执行边界清晰、可以通过测试或 Diff 验证的代码修改任务。"

model = "gpt-5.6-luna"
model_reasoning_effort = "high"
sandbox_mode = "workspace-write"

developer_instructions = """
你是一个专门负责执行明确代码任务的开发 Agent。

工作要求：

1. 只处理父 Agent 明确委托的任务，不自行扩大范围。
2. 开始修改前，先确认目标文件、预期行为和验证方式。
3. 优先读取与任务直接相关的文件，不扫描整个代码仓库。
4. 采用最小修改原则，不重构无关代码。
5. 不修改未被明确要求处理的配置、依赖或公共接口。
6. 修改完成后运行最相关的测试、类型检查或构建命令。
7. 如果任务信息不足、存在架构决策或影响范围不明确，停止修改并返回父 Agent。
8. 最终返回：
   - 修改了哪些文件；
   - 每项修改的原因；
   - 执行了哪些验证；
   - 测试是否通过；
   - 尚未解决的风险。
9. 不创建新的子 Agent，不继续向下委托任务。
"""

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

请为当前 Codex 环境创建一个自定义执行 Agent。

要求：

1. 如果是个人通用配置，在 ~/.codex/agents/ 下创建 luna-worker.toml。
2. 如果当前项目已经使用 .codex 目录，则优先创建项目级配置：
   .codex/agents/luna-worker.toml。
3. Agent 名称设置为 luna_worker。
4. 模型设置为 gpt-5.6-luna。
5. model_reasoning_effort 默认设置为 high，不要直接使用 max。
6. sandbox_mode 设置为 workspace-write。
7. Agent 只负责边界明确、可通过测试或 Diff 验证的任务，例如：
   - 修改指定代码；
   - 修复已定位 Bug；
   - 补充测试；
   - 处理类型和格式错误；
   - 运行测试并汇总结果。
8. 遇到架构决策、需求不明确、跨模块影响或安全问题时，不要擅自处理，返回父 Agent 决策。
9. 禁止该 Agent 再创建子 Agent。
10. 创建完成后：
    - 输出文件完整路径；
    - 检查 TOML 语法；
    - 显示完整配置内容；
    - 使用 git diff -- .codex/agents/luna-worker.toml 展示 Diff；
    - 如果文件位于用户主目录而不在 Git 仓库中，则使用适合当前系统的命令展示新旧差异；
    - 不要修改其他文件。

1
2
3
4
5
6
7

先由主 Agent 分析问题、确定修改方案和验收条件。

方案确定后，将边界清晰的代码修改交给 luna_worker 执行。

luna_worker 完成后，主 Agent 必须检查 Diff、测试结果和潜在回归风险。

不要让 luna_worker 负责架构决策，也不要让多个 Agent 重复扫描整个仓库。

1
2
3
4
5
6
7
8
9

请先分析这个 Bug 的根因，不要立即修改代码。

确认根因后，把最小修复任务交给 luna_worker：
- 只修改与该 Bug 直接相关的文件；
- 补充回归测试；
- 运行相关测试；
- 返回修改摘要和测试结果。

最后由主 Agent 审查 Diff，确认没有扩大修改范围。

1

只检查 src/auth/session.ts 和 tests/session.test.ts

1

检查整个项目并修复登录问题

1
2
3
4

Sol：复杂分析、架构决策、最终审查
Terra：代码探索、较复杂的辅助分析
Luna Medium/High：明确修改、测试和批量任务
Luna Max：少量复杂但范围明确的任务