donvito/codex-astra-luna-orchestrator

它是什么

Codex Astra/Luna Orchestrator 是一个辅助包，为 Codex CLI 工具添加了现成的 orchestration 配置。它捆绑了一组 sub-agents（explorer、worker、tester、researcher、reviewer），每个代理都与特定的 GPT-6 模型变体（Astra、Sol、Luna）绑定。通过将提供的 profiles 之一安装到目标代码库中，开发人员可以获得一个预先配置好的多代理工作流，能够自动规划、实现、测试和审查变更。

适用对象

任何已经使用 Codex 命令行界面，并希望为大型编码任务（例如构建新功能、重构或生成端到端实现）使用即插即用多代理设置的人。

核心概念

概念	含义
Orchestrator	协调整个工作的根代理（Astra 或 Sol）。
Sub-agents	执行特定角色的个别 GPT-6 Luna 代理：explorer（映射问题）、worker（编写代码）、tester（运行检查）、researcher（收集信息）。
Reviewer	在合并前验证输出的独立代理（Astra 或 Sol）。
Profile	`profiles/` 下的一个文件夹，包含完整的配置 (`.codex/`) 和技能文件 (`.agents/`)。选择配置文件会将这些文件复制到目标仓库中。
Skill	`astra-orchestrator` 技能定义 (`SKILL.md`)，告诉 Codex 如何调用编排工作流。

如何获取

Clone 仓库。
运行平台特定的安装程序 (setup.sh 或 setup.ps1)。
当脚本询问时，指向您想要增强的其他仓库并选择一个配置文件 (1-6)。安装程序会复制：
- .codex/config.toml 和每个角色的 .toml 文件到目标的 .codex/ 目录中。
- 技能文件到目标的 .agents/skills/astra-orchestrator/ 中。
- 一个 AGENTS.md 文件（或附加到现有文件），记录可用的代理。

使用编排器

从目标项目目录运行 Codex CLI：

codex

Codex 将自动加载已安装的技能。您也可以明确调用它：

$astra-orchestrator
Implement the invoice export endpoint. Use the explorer to map the path, a worker to implement it, and the tester and reviewer to verify it.

编排器随后会启动四个 Luna 子代理，让它们协作，最后将结果交给审查代理。

配置文件概览

#	名称	根模型	执行模型	审查模型	并发子代理
1 (默认)	`pro`	Astra (medium)	Luna (max)	Astra (low)	4
2	`plus`	Luna (max)	Luna (medium)	Astra (low)	4
3	`pro-max-2-subagents`	Astra (medium)	Luna (max)	Astra (low)	2
4	`plus-max-2-subagents`	Luna (max)	Luna (medium)	Astra (low)	2
5	`GPT6-SolMax-LunaMax`	Sol (max)	Luna (max)	Sol (max)	4
6	`GPT6-SolMedium-LunaMax`	Sol (medium)	Luna (max)	Sol (medium)	4

选择符合您拥有的模型访问权限（Astra、Sol 或 Luna）以及所需并行级别的配置文件。

文档与辅助工具

Guides – guides/ 中的逐步 markdown 文件，涵盖完整编排、plus-profile 设置、快速迭代、日常编码、复杂仓库工作和 Token 使用量测量。
Scripts – 一个小型 Python 工具 (scripts/token_usage.py)，用于追踪 Token 消耗。
Tests – 验证配置文件和 Token 使用逻辑的单元测试 (tests/)。

许可

Apache 2.0 – 可自由使用、修改和重新分发。

以上所有详细信息均直接取自仓库的 README；未推断任何额外功能。