用途:把较大的编码或仓库审查任务拆成两阶段执行。Sol 作为指挥官与验证者,不直接编辑目标产品文件;Luna Max 作为独立 CLI 工作进程,承担一项有边界的实现、修复、测试或只读调查。
主要能力:区分技能激活与工作进程派发;固定新启动和恢复的工作进程为 gpt-5.6-luna、推理强度 max;同一工作树内只允许一个可写入的 Luna 工作进程,只读工作可并行;保持父级审批与沙箱边界不变;对委派编码任务关闭 Apps、Plugins 等上下文;配置失败时按 config_incompatible 报告而非绕过;同一根因三次纠错循环后停止并重新评估假设;不凭工作进程摘要声称完成,须在当前会话验证。
使用方式:先做 preflight,确认工作目录与 Git 根,查看脏状态、AGENTS.md 和仓库验证命令,声明目标、约束、允许文件、完成条件与命令预算。实现使用 workspace-write 默认 1800 秒,调查使用 bounded-review 只读、900 秒、最多 8 条命令。任务写在目标仓库外的临时 UTF-8 文件。运行示例: python3 <skill-dir>/scripts/run_luna_worker.py run --cwd /absolute/path/to/repo --prompt-file /absolute/path/to/task.md --sandbox workspace-write 审查时加 --profile bounded-review。每次运行向 $CODEX_HOME/state/sol-luna-router/runs.jsonl 追加不含提示与回复文本的记录。验证后可用 annotate 追加结果,用 analyze_run_log.py 汇总可靠性、质量与成本;信用估算需显式加 --rate-card,属有日期基准假设而非当前定价。纠错用 resume 复用同一 thread-id。
适用场景:需要明确指挥与独立验证分离的编码或仓库审查任务,以及需要隔离、可审计地执行单项实现或只读调查的场合。
限制:仅当用户明确要求 Luna 或确有必要时才启动;不用于小型简单任务。不得添加绕过、全权限、强推、凭据或密钥处理标志。--allow-non-git 仅在用户明确要求在 Git 仓库外工作时使用;原始事件默认关闭。不要用工作进程超时当测试预算。报告中的 token 总量仅覆盖 Luna,不含 Sol;不能仅凭调用次数、工作进程成功或 token 总量断言该技能有效。