先咨询再拍板:Sol Advisor如何用"新鲜Sol咨询"降低架构决策风险
【免费下载链接】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 架构编排插件,它让 GPT-5.6 Sol 担任"架构师",用**新鲜Sol咨询(fresh Sol consult/review)**机制在关键节点独立复核方案与代码,从而降低 AI 辅助开发中的架构决策风险。本文带你了解这套多智能体工作流的原理、角色分工和上手方法。
🧭 什么是 Sol Advisor?
一句话概括:Sol 坐镇指挥,Luna 干活,Terra 攻坚,新鲜的 Sol 做最终验收。
在 AI 辅助编程中,一个常见陷阱是:让同一个 AI 既写代码又验收自己的代码——它很容易"自己给自己打分"。Sol Advisor 的做法是把职责拆开:
| 阶段 | 角色 | 职责 |
|---|---|---|
| 规划 | Sol / High(主会话) | 理清需求、架构设计、写完整规格、验收 |
| 常规实现 | Luna / Max | 处理边界清晰、已完整定义的日常任务 |
| 显式升级 | Terra / High | 处理判断密集、高风险任务 |
| 最终评审 | 新鲜的 Sol / High | 独立审查真实 diff,给出放行结论 |
主会话 Sol 全程保留"架构师"身份:解决歧义、选择接口、重跑验证、判断是否需要升级或返工。实现代码则交给专职的"工人",架构决策始终留在最强的推理通道里。
🧩 三条"咨询通道"是怎么分工的?
Sol Advisor 的三个工人都是 Codex 原生自定义智能体,模型和推理强度在角色文件中"钉死",避免临时切换:
- Luna / Max(常规通道):默认路线。适合有界、完全指定的任务;遇到模糊或失败会如实上报,而不是擅自改架构。角色定义见 sol-advisor-luna-implementer.toml
- Terra / High(升级通道):判断密集、高风险、影响面大的任务直接走它;或当 Luna 修正一次后仍暴露"其实不是常规任务"时升级。角色定义见 sol-advisor-terra-implementer.toml
- 新鲜 Sol / High(评审通道):每次都是全新上下文,请求只读沙箱,只看真实文件和证据。角色定义见 sol-advisor-sol-reviewer.toml
"新鲜"是关键:评审者与写代码的会话共享的历史为零,不会顺着原来的思路自我说服。这就是"新鲜Sol咨询"想解决的问题。
🎯 "新鲜Sol咨询"如何降低架构决策风险?
除了最终代码评审,Sol Advisor 还定义了commitment-boundary Sol consult(承诺边界咨询),专门针对"拍板前"的高风险时刻:
当涉及影响重大的架构选择、数据迁移、公开 API 或大范围重构时,主会话可以启动同一个新鲜 Sol 角色(
fork_turns: none,零历史携带),把"拟议决策、目标、约束、相关路径、备选方案,以及那个会改变计划的关键问题"交给它,要求返回proceed(继续)、change(改方案)或stop(停下),并给出决定性理由与最大风险。
完整规则在 role-contracts.md 的 "Commitment-boundary Sol consult" 一节。它带来的收益:
- 拍板前有独立视角:关键决策不再是"一个会话自言自语",而是先交给干净上下文的专家咨询;
- 只问一个决定性问题:咨询聚焦"那个会改变计划的问题",避免泛泛讨论;
- fail-closed 原则:路由证据缺失、不一致或不可观测时直接停线,绝不静默降级到别的模型或角色。
评审环节同样严格:新鲜 Sol 必须返回三种裁决之一——
ship:可交付,附验证证据;fix-first:委托修复、重新验证,并再次获得新鲜评审;rethink:架构需要推翻重想,不得宣称完成。
而且评审者永远不自己改代码,任何修复都会使旧裁决失效——必须再来一次全新评审。这套闭环写在工作流定义 SKILL.md 中。
🚀 快速上手:安装与使用步骤
1. 环境要求
- 较新版本的 Codex CLI 或开启了插件的 ChatGPT 桌面端
- GPT-5.6 Sol / High 作为主会话
- 原生自定义智能体能力(可访问 Luna / Max 与 Terra / High)
jq用于定位已安装的插件包
2. 安装插件
将仓库添加为 Codex 市场源并安装插件(本地开发可直接指向仓库目录):
codex plugin marketplace add DannyMac180/sol-advisor --ref main codex plugin add sol-advisor@sol-advisor3. 安装三个角色模板并自检
插件安装不会自动注册智能体文件,需单独运行一次安装脚本,再跑一次"只检查、不改动"的校验:
sh "$plugin_dir/scripts/install-agents.sh" sh "$plugin_dir/scripts/install-agents.sh" --check安装器是"失败即停、只读安全"的:不会覆盖已有配置,所有文件均逐字节校验。脚本见 install-agents.sh。
4. 开新任务并使用
注意:安装后要开一个新任务,原生智能体在任务创建时才被发现。选 GPT-5.6 Sol(High 推理)为主会话,然后显式调用编排技能:
Use $sol-advisor:orchestration to build this feature, verify it, and obtain the fresh Sol review before reporting done.5. 验证路由证据(可选但推荐)
当公开元数据没有暴露模型或推理强度时,可用本地只读检查器核对实际路由:
sh "$plugin_dir/scripts/inspect-agent-runtime.sh" <native-subagent-thread-id>该工具见 inspect-agent-runtime.sh,它只输出白名单字段,缺失或矛盾时直接拒绝,绝不"猜测"结果。仓库自带的自检脚本是 verify.sh。
📌 总结:为什么"先咨询再拍板"值得借鉴?
Sol Advisor 的核心思想可以用三句话概括:
- 架构决策留在最强推理通道,实现工作交给专用工人;
- 关键节点先咨询:重大拍板前引入新鲜上下文的独立咨询,返回 proceed / change / stop;
- 验收永远由新鲜评审完成:ship / fix-first / rethink 三选一,修复即重审,杜绝"既当运动员又当裁判"。
对新手来说,这套"多智能体工作流 + 新鲜评审"的打法即使不装插件,也值得借鉴到自己的 AI 辅助开发流程中:让写代码和验收代码的上下文彻底分开,是控制 AI 编程架构风险最简单有效的手段之一。
相关文档速查:
- 编排工作流主文件:plugins/sol-advisor/skills/orchestration/SKILL.md
- 角色契约与评审提示词:plugins/sol-advisor/skills/orchestration/references/role-contracts.md
- 插件元信息与界面配置:plugin.json
【免费下载链接】sol-advisorCodex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.项目地址: https://gitcode.com/gh_mirrors/so/sol-advisor
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考