让 Astra 做判断，让 Luna 和 Sol 做实现，交付前再由独立 Astra 审查。
Astra Advisor 是一套面向 Codex 的多模型协作插件：把需求、执行和验收的责任写清楚，让不同难度的任务进入合适的执行通道，并用实际文件和测试结果判断是否完成。
它包含编排 skill、三份原生 agent 定义，以及带冲突保护的本地安装脚本。适合希望在一个 Codex 主持会话中完成“拆解 → 实现 → 验证 → 审查”的开发者。
| 角色 | 模型 / 推理强度 | 负责什么 |
|---|---|---|
| 主持 | GPT-6 Astra / 当前会话设置 | 明确需求、制定方案、选择执行通道、核对证据、验收 |
| 常规执行 | GPT-5.6 Luna / max | 做法明确、接口确定的实现与修复 |
| 较复杂执行 | GPT-5.6 Sol / medium | 跨文件逻辑、状态处理、排障和局部重构 |
| 独立审查 | GPT-6 Astra / 显式传入主持强度 | 检查实际改动、测试证据和回归风险，给出通过或返工意见 |
Astra 直接选择 Luna 或 Sol，不要求每个任务依次经过三个模型。Sol 的 medium 与 Luna 的 max 是各自的推理设置，不是跨模型的能力排名。
- 任务有边界：每次派发包含目标、文件范围、接口、约束、验证要求和通道。
- 执行者不递归：Luna、Sol 直接完成被分配的任务，不再派发子代理。
- 结果有证据：检查实际文件、未跟踪产物和测试输出，不能只凭退出码或空 diff 报告完成。
- 失败不隐藏：模型不可用时明确报告，不自动替换模型或强度；连续两次修复失败后回到主持重新判断。
- 审查有结论：独立 Astra 返回
SHIP、FIX_FIRST或RETHINK，返工回原执行者。
当前版本在 macOS、Codex CLI 0.153.4、Python 3.11 上验证过；其他环境尚未完成同等验证。你需要：
- 已安装并登录的 Codex CLI，以及 Astra、Luna、Sol 的模型访问权限。
- Python 3.11 或更新版本，以下
python3应指向该版本。 - Codex 的
plugin-creator系统 skill。安装脚本依赖它注册个人 marketplace，不在仓库中重复打包。
codex --version
python3 --version
test -f "$HOME/.codex/skills/.system/plugin-creator/scripts/create_basic_plugin.py"若最后一条失败，请先确认 Codex 环境是否提供 plugin-creator；自定义位置可通过安装参数 --plugin-creator /path/to/create_basic_plugin.py 指定。缺少该依赖时，先不要执行安装。
git clone https://github.com/Altria600/astra-advisor.git
cd astra-advisor
python3 scripts/install_local.py install
codex plugin add --enable plugins astra-advisor@personalpersonal 是默认个人 marketplace 名称；已有 marketplace 若使用其他名称，请替换为其实际 name。--enable plugins 只对当前命令启用插件功能，不修改全局开关。
| 安装内容 | 默认位置 |
|---|---|
| 插件副本 | ~/plugins/astra-advisor |
| 三份原生 agent | ~/.codex/agents/ |
| 个人 marketplace | ~/.agents/plugins/marketplace.json |
源码仓库保留在克隆位置。安装不会修改全局默认模型、权限或凭据；已有其他插件和 agent 保留。同名内容不同会停止，完全相同的重复安装会跳过。
进入你真正要处理的项目目录，然后启动新会话：
codex --enable plugins -m gpt-6-astra -c model_reasoning_effort=medium输入：
使用 $astra-advisor 完成这项任务：……
先确认目标和验收条件，再选择 Luna 或 Sol 执行。
检查实际产物和测试结果，最后安排独立 Astra 只读审查。
插件不会自动切换已运行会话的模型。
使用 $astra-advisor，把这个任务交给 luna-implementer。
目标：为已有的用户列表接口增加分页。
文件范围：先定位该接口、调用方和对应测试，列清边界再派发。
接口：沿用项目现有的分页参数与响应格式。
约束：不改变权限校验，不重构无关模块。
验证：新增分页边界用例，并运行受影响测试。
完成后由 Astra 核对并安排独立只读审查。
使用 $astra-advisor，把这个问题交给 sol-implementer。
目标：定位并修复重复提交导致重复创建订单的问题。
先定位请求入口、去重逻辑和测试，明确可修改文件范围。
保持现有接口兼容，不引入未经确认的数据库变更。
用可复现测试证明问题与修复，并回传 JUDGMENT 说明关键判断。
最后安排独立 Astra 只读审查。
当前默认最终审查使用独立 Astra CLI，并显式设置 --sandbox read-only。 Luna 和 Sol 仍通过原生 agent 派发。
在已验证的 Codex CLI 0.153.4 环境中，父会话的运行时权限覆盖会传入子代理：原生 reviewer 即使配置 read-only，实际仍可能获得可写权限。省略 reviewer 的 effort 也可能落到全局子代理默认值。因此本项目不会把角色说明中的“只读”当作沙箱隔离证据。
下面是独立调用示例。将 medium 替换为主持实际强度，替换项目路径和审查内容：
cat <<'REVIEW' | codex exec -m gpt-6-astra -c model_reasoning_effort=medium --sandbox read-only --cd /path/to/project -
目标：检查本次实际交付是否满足需求。
约束：只读，不编辑文件，不启动编排或派发子代理。
验证：检查实际改动、未跟踪文件和指定测试的运行证据。
职责：指出需求遗漏与回归风险，返回 SHIP、FIX_FIRST 或 RETHINK。
REVIEW仅当目录本来不是 Git 项目且任务不要求 Git 验证时，才额外使用 --skip-git-repo-check，并以实际文件和产物验收。已知仓库中的 Git 检查失败必须报告，不能忽略。
原生 astra-advisor 定义仍保留；只有运行记录证实它获得了预期模型、强度和只读沙箱，才可用它替代最终 CLI 通道。参见 Codex 子代理说明。
| 检查 | 已验证结果 |
|---|---|
| 安全安装与卸载 | 11 项测试通过：重复安装、冲突、源码保护、符号链接与其他插件保留 |
| 两条真实执行通道 | Luna / max、Sol / medium 正确生效，临时项目 7 项测试通过 |
| 失败处理 | 失败命令未报告完成；无效模型被明确拒绝，无自动替换 |
| 独立最终审查 | 实际为 Astra / medium / read-only，结论 SHIP |
这些结果来自指定环境的验收，不构成模型质量、价格或速度的跨任务基准。详情见 验收摘要。
本地复验（同样需要前述 plugin-creator 依赖）：
PYTHONDONTWRITEBYTECODE=1 python3 -B -m unittest -v tests/test_install_local.py
git diff --check只读审查环境可能无法创建测试临时目录；这种情况必须标为“未运行”，由主持在允许写入临时目录的环境中补验。
相同内容重复安装会跳过。拉取新版本后，旧副本若与源码不同，安装脚本会停止；当前不提供自动覆盖升级。升级前请保留旧源码版本，使用与旧安装对应的源码卸载，再安装新版；不要直接删除或覆盖冲突文件。
从安装时保留的源码目录执行：
codex plugin remove --enable plugins astra-advisor@personal
python3 scripts/install_local.py uninstall安全卸载仅处理与源码匹配、未被修改的本插件副本、三份代理和 marketplace 条目。出现修改或额外内容时会停止，保留源码及其他插件。
.codex-plugin/plugin.json 插件清单
skills/astra-advisor/SKILL.md 编排与验收规则
agents/ Luna / Sol / Astra 原生定义
scripts/install_local.py 安全安装与卸载
tests/test_install_local.py 安装回归测试
docs/acceptance.md 验收摘要与限制
assets/ 中文介绍配图
本项目由 Altria600 基于 Dan McAteer 的 Fable Advisor 改造，保留上游 Git 历史、原作者署名与 MIT 许可证。主要变化是 Codex 原生代理、固定的 Luna / max 与 Sol / medium 分工，以及经过本机验证的独立 Astra 只读审查通道。
这是社区项目，不是 OpenAI 官方插件。