从GitHub Marketplace到本地开发Sol Advisor插件部署与定制完全指南【免费下载链接】sol-advisorCodex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.项目地址: https://gitcode.com/gh_mirrors/so/sol-advisorSol Advisor 是一款面向 Codex 的 AI 编程编排插件它让架构师会话Sol 负责规划Luna 负责常规实现Terra 负责高难度升级处理最后由全新的 Sol 审查者把关。本文将从 Marketplace 一键安装、角色注册、路由原理到本地开发与定制带你完整跑通这套 AI 多智能体工作流。 Sol Advisor 是什么一条流水线式的 AI 交付工作流Sol Advisor 的核心思想很简单让合适的模型干合适的活。它不是一个大模型包办一切而是把一次完整的软件交付拆成四个阶段每个阶段都由固定规格的智能体角色执行阶段角色规格职责规划Sol 主会话GPT-5.6 Sol / High需求澄清、架构设计、任务分解、完整规格常规实现Luna 实现者GPT-5.6 Luna / Max执行边界清晰、完全指定好的常规任务升级处理Terra 实现者GPT-5.6 Terra / High判断密集、高风险的工作或 Luna 一次修正后暴露误判时接管最终审查Sol 审查者GPT-5.6 Sol / High全新会话只读审查 diff返回ship/fix-first/rethink三条实现/审查通道各自对应一个 TOML 角色模板你可以在仓库中直接查看它们的性格设定常规实现者sol-advisor-luna-implementer.toml升级实现者sol-advisor-terra-implementer.toml只读审查者sol-advisor-sol-reviewer.toml 关键规则审查者永远不自己改代码任何修复之后都必须重新跑一次全新审查。这是 Sol Advisor 保证质量闭环的底线设计。 安装前准备4 个硬性要求部署 Sol Advisor 插件前请确认你的环境满足以下要求Codex CLI 或 ChatGPT 桌面应用新版且已启用插件功能主会话可使用GPT-5.6 Sol / High推理规格支持原生自定义智能体custom agents并可访问 Luna / Max 与 Terra / High系统装有jq用于定位已安装的插件目录如需获取插件源码本地开发和定制需要克隆仓库git clone https://gitcode.com/gh_mirrors/so/sol-advisor 一键安装步骤从 Marketplace 部署插件第一步把仓库注册为 Codex 插件市场源第一个参数填你手中的 Sol Advisor 仓库地址--ref main锁定主干分支codex plugin marketplace add sol-advisor仓库地址 --ref main第二步安装插件codex plugin add sol-advisorsol-advisor到这里编排技能orchestration skill就已经可用了。但请注意插件安装不会自动注册三个角色模板下一步必须手动完成。 注册三大角色Luna、Terra、Sol 就位插件自带的安装脚本 install-agents.sh 负责把三个角色模板装进你的 Codex 智能体目录。它的设计非常保守不覆盖、不删改、先预检后落盘——被修改过、符号链接或不安全的目标文件都会被原样保留并报告为冲突。plugin_dir$(codex plugin list --json | jq -r .installed[] | select(.pluginId sol-advisorsol-advisor) | .source.path) sh $plugin_dir/scripts/install-agents.sh # 安装缺失模板 sh $plugin_dir/scripts/install-agents.sh --check # 只读校验逐字节比对未显式指定目录时脚本优先使用CODEX_HOME环境变量指向的位置否则回退到默认的~/.codex/agents--check是非破坏性检查退出码为 0 表示三个角色文件与模板逐字节一致可放心使用⚠️ 检查通过后请开启一个全新的 Codex 任务——原生智能体类型只在任务创建时被发现旧任务看不到新装的角色。一切就绪后在主会话中显式调用编排技能即可开工Use $sol-advisor:orchestration to build this feature, verify it, and obtain the fresh Sol review before reporting done. 路由原理Sol 规划、Luna 实现、Terra 兜底理解路由机制你就理解了 Sol Advisor 的全部精髓。整个流程由主会话架构师驱动完整契约写在 role-contracts.mdSol 主会话写出完整的五段式实现规格OBJECTIVE目标、FILES AND OWNERSHIP文件所有权、INTERFACES接口、CONSTRAINTS约束、VERIFICATION验证命令与预期结果默认派给 Luna边界清晰、完全指定的常规任务走 Luna / Max两种情况升级到 Terra一开始就是判断密集/高风险的工作或 Luna 修正一次后证明任务被误判为常规父会话亲自验证检查真实 diff、重跑验证命令绝不轻信子任务的口头汇报全新 Sol 审查者终审只读沙箱、全新上下文只返回ship交付、fix-first先修再审或rethink架构需重想 一个值得记住的细节模型与推理强度由角色 TOML钉死派生时不传任何 per-spawn 覆盖字段——从机制上杜绝悄悄换模型。技能的完整工作流定义见 SKILL.md插件在 Codex 侧的展示配置见 openai.yaml。️ 校验与升级保持原生路由可信当你需要绝对信任路由行为时随时跑一遍校验组合sh $plugin_dir/scripts/install-agents.sh --check # 角色文件与模板逐字节一致仓库还内置了两个自检工具方便你深入了解内部实现verify.sh仓库级自验证脚本一次性检查角色模板、技能、契约文档等全部构件是否齐整一致inspect-agent-runtime.sh运行时取证工具传入子任务线程 ID 即可输出只读白名单内的路由元数据角色、模型、推理强度它对缺失、矛盾或不可观察的证据一律拒报绝不做模型回退猜测升级插件并同步角色模板的流程codex plugin marketplace upgrade sol-advisor codex plugin add sol-advisorsol-advisor sh $plugin_dir/scripts/install-agents.sh sh $plugin_dir/scripts/install-agents.sh --check️ 本地开发与定制让插件指向你的仓库想修改技能文案、调整角色提示词或给团队做二次开发把本地检出注册为本地市场源即可Codex 会直接读取你目录里的文件cd /absolute/path/to/sol-advisor codex plugin marketplace add /absolute/path/to/sol-advisor codex plugin add sol-advisorsol-advisor定制时的三条实用建议改模板要成对进行--check是逐字节比对的你修改了角色 TOML 却不更新模板检查会报冲突。建议同时维护 agents/ 里的模板与用户侧安装副本并跑一遍--check确认别绕过失败设计哲学是失败即停fail-closed。检查不过时不要悄悄换内置智能体顶替而是按报告修复冲突——这正是它能被信任的原因改完先自检在仓库内运行sh plugins/sol-advisor/scripts/verify.sh它会校验全部构件的一致性相当于你本地版本的 CI许可证见 LICENSE完整背景与演进说明见 README.md。✅ 常见问题速答Q装完插件Luna / Terra 怎么没反应角色模板未安装或任务太旧。运行install-agents.sh加--check然后开一个新任务——原生智能体只在任务创建时被发现。Q为什么审查者不能顺手把问题修了审查与实现分离是质量闭环的基石修复会使上一轮结论作废必须再跑一次全新审查。fix-first的完整循环是修复 → 父会话验证 → 新审查。QLuna 做错了能直接让 Terra 接手吗可以但要有依据一次修正后的失败证明任务属于判断密集或高风险类型这才触发显式升级且必须携带修正后的规格。Q能只装技能、不装三个角色吗可以但原生路由的预检preflight会因缺少角色而停止对应通道。Sol Advisor 的完整性依赖技能 三角色同时就位。 到这里你已经掌握了 Sol Advisor 从 Marketplace 部署、角色注册、路由原理到本地定制的全链路操作。这套规划—实现—升级—审查的流水线正是让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考