Sol Advisor快速上手：5分钟装好三角色AI编程工作流，让每次交付都有强制终审

Sol Advisor快速上手：5分钟装好三角色AI编程工作流，让每次交付都有强制终审

【免费下载链接】sol-advisorCodex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.项目地址: https://gitcode.com/gh_mirrors/so/sol-advisor

Sol Advisor 是一个为 Codex 打造的 AI 编程工作流插件：由 Sol 架构师会话负责规划与验收，Luna 和 Terra 分别承担常规实现与高风险升级实现，并在每次交付前强制进行一次全新的 Sol 终审。本指南带你快速完成 Sol Advisor 安装，搭建这条“三角色 + 强制终审”的 AI 编程工作流，并了解它的核心原理。

1️⃣ Sol Advisor 是什么：一句话讲清三角色分工

想象一个真实团队里的三个人：架构师、工程师和独立审查员。Sol Advisor 就是把这种分工固化进 AI 编程流程，每个角色绑定固定模型与推理档位：

这套 AI 多角色编程工作流最硬核的一点：终审不是可选项。主会话验证完 diff 之后，必须派生一个“全新上下文”的 Sol 审查员；审查员永远不自己修 bug，任何修改都会让旧结论作废，必须重新走一轮全新终审。

三个角色的“身份档案”就在仓库里，一眼就能看懂各自绑定的模型与约束：

• 终审审查员：sol-advisor-sol-reviewer.toml（内置read-only沙箱，只审不改）
• 常规实现：sol-advisor-luna-implementer.toml
• 升级实现：sol-advisor-terra-implementer.toml

2️⃣ 安装前检查：确认你的 Codex 环境满足4个条件

在动手之前，先确认以下 4 项（缺一不可，否则会卡在第一步）：

1. 最新版的Codex CLI或ChatGPT 桌面版（已开启 plugins 功能）；
2. 主会话可用GPT-5.6 Sol / High；
3. 原生自定义 Agent 功能可用，且能访问GPT-5.6 Luna / Max与GPT-5.6 Terra / High；
4. 系统装有jq（用于定位插件安装目录）。

💡 小技巧：模型档位是由角色 TOML 文件“钉死”的，派生子 Agent 时不要再额外覆盖模型参数——这也是 Sol Advisor 防止“静默降级”的关键设计。

3️⃣ 一键安装步骤：3条命令装好插件 + 3个角色文件

第 1 步：添加市场并安装插件

codex plugin marketplace add DannyMac180/sol-advisor --ref main codex plugin add sol-advisor@sol-advisor

第 2 步：安装三角色自定义 Agent

⚠️ 关键点：插件安装不会自动注册用户级自定义 Agent 文件，三个角色模板需要单独安装，然后用内置的“只读校验”确认：

plugin_dir="$(codex plugin list --json | jq -r '.installed[] | select(.pluginId == "sol-advisor@sol-advisor") | .source.path')" test -n "$plugin_dir" test -d "$plugin_dir" sh "$plugin_dir/scripts/install-agents.sh" sh "$plugin_dir/scripts/install-agents.sh" --check

这条安装命令由 install-agents.sh 驱动，默认安装到$CODEX_HOME/agents或~/.codex/agents。它是失败即停、绝不覆盖的设计：已修改过、符号链接、内容冲突的文件一律原样保留并报告为冲突，安装完成后还会逐字节核对三个文件与模板一致。

第 3 步：开新任务，调用编排技能

校验通过后，新开一个 Codex 任务（原生 Agent 是在任务创建时发现的，旧任务看不到新装的角色），主会话选择 GPT-5.6 Sol + High 推理，然后显式调用编排技能：

Use $sol-advisor:orchestration to build this feature, verify it, and obtain the fresh Sol review before reporting done.

这个技能的行为定义在 SKILL.md，其入口配置见 openai.yaml。

4️⃣ 工作流怎么跑：计划 → 实现 → 验证 → 强制终审

安装完成后，每次交付都会走这条标准流水线：

Sol/High 规划（完整五段式规格说明） └→ Luna/Max 默认实现常规工作 └→ 父会话检查真实 diff、重跑验证命令 └→ Fresh Sol/High 全新终审 ├─ ship → 携带证据宣告完成 ├─ fix-first → 修复后重新验证 + 再来一轮全新终审 └─ rethink → 架构要改，不许宣布完成

几个新手最容易忽略的细节：

• 五段式任务单：每个实现提示词必须包含 OBJECTIVE、FILES AND OWNERSHIP、INTERFACES、CONSTRAINTS、VERIFICATION 五部分，外加结构化回报模板。完整契约见 role-contracts.md；
• 只给有界的责任：每个执行者只负责一套文件或一块边界清晰的责任，且不独占代码库——要保留并发的他人修改；
• 升级是显式的：判断密集 / 高风险的工作从一开始就交给 Terra；Luna 纠正一次仍暴露“这不是常规活”时，也要显式升级到 Terra，没有静默兜底。

5️⃣ 进阶两招：升级插件 + 查看运行时路由证据

升级插件（会顺带迁移被识别的历史角色文件）：

codex plugin marketplace upgrade sol-advisor codex plugin add sol-advisor@sol-advisor plugin_dir="$(codex plugin list --json | jq -r '.installed[] | select(.pluginId == "sol-advisor@sol-advisor") | .source.path')" test -d "$plugin_dir" sh "$plugin_dir/scripts/install-agents.sh" sh "$plugin_dir/scripts/install-agents.sh" --check

核查运行时证据：当你需要确认子 Agent 真的跑在了正确的模型档位上时，用随仓库附带的只读检查器（传原生子线程 ID）：

sh "$plugin_dir/scripts/inspect-agent-runtime.sh" <native-subagent-thread-id>

这个检查器只输出白名单内的路由字段，拒绝猜测模型或推理档位；它和校验脚本 verify.sh 一起，构成 Sol Advisor 对“角色-模型绑定”的可审计防线。

6️⃣ 新手常见问题速查（FAQ）

Q：为什么装完插件后任务里看不到三个角色？A：原生 Agent 在任务创建时发现。装完后必须开新任务；仍看不到就先跑install-agents.sh --check，确认 Codex 已更新。

Q：--check报 missing / conflict 怎么办？A：missing 表示某角色文件缺失，重跑不带--check的安装命令即可；conflict 表示本地文件被改过且与模板不一致——脚本不会替你覆盖，请人工确认后处理，切勿用其他模型或角色“绕过去”。

Q：终审说 fix-first，我修完之后还要再审吗？A：要。任何修改都会让上一轮结论作废，必须再派生一个全新的 Fresh Sol 审查员，拿到新的ship才能宣告完成——这正是“每次交付都有强制终审”的含义。

Q：审查员为什么坚持只读？A：审查员内置read-only沙箱请求（见 sol-advisor-sol-reviewer.toml），且规则禁止审查员自己实现修复——审的人不干活，干活的人不自审，结论才可信。

结语：把“AI 交付质量”变成流程问题，而不是运气问题 🎯

Sol Advisor 的快速上手流程其实只有三步：装插件 → 装三角色 → 开新任务用 orchestration 技能。但它的价值在于把 AI 编程里最脆弱的环节——“谁验收、怎么验收”——变成了不可绕过的流程：Sol 负责想清楚，Luna 负责快，Terra 负责稳，而全新 Sol 终审负责在每次交付前最后关一道门。花 5 分钟装好这条工作流，你的下一次 AI 交付就不再靠运气了。

【免费下载链接】sol-advisorCodex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.项目地址: https://gitcode.com/gh_mirrors/so/sol-advisor