
10个Sol Advisor实战技巧从规格书到升级决策一篇学会AI编排的完整流程【免费下载链接】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 智能体做只读审查。掌握下面 10 个实战技巧你就能从零跑通规格书 → 实现 → 验证 → 审查 → 交付的完整 AI 工作流。技巧1先搞懂三个角色的分工 Sol Advisor 的核心设计是能力路由——不同难度的工作交给不同能力的智能体。理解这张分工表是后续所有技巧的基础阶段角色职责规划Sol / High解析意图、架构设计、任务分解、编写完整规格书常规实现Luna / Max默认处理边界清晰、规格完整的常规任务显式升级Terra / High处理判断密集、高风险或大范围影响的任务最终审查全新的 Sol / High独立审查实际 diff返回 ship / fix-first / rethink三个角色的人设都固定在 TOML 模板里可分别查看 Luna 实现者、Terra 实现者 和 Sol 审查者。注意 Sol 审查者额外声明了只读沙箱这是后面技巧 9 的前提。技巧2三步完成安装安装分两部分插件本体 三个自定义智能体模板。在 Codex 中执行codex plugin marketplace add DannyMac180/sol-advisor --ref main codex plugin add sol-advisorsol-advisor然后是关键一步——插件安装不会自动注册智能体文件需要单独运行安装脚本plugin_dir$(codex plugin list --json | jq -r .installed[] | select(.pluginId sol-advisorsol-advisor) | .source.path) sh $plugin_dir/scripts/install-agents.sh完整的安装说明在 README.md 的 Install from GitHub 一节。技巧3安装后永远先跑一次无副作用检查 ✅install-agents.sh 提供了--check模式它会逐字节验证已安装的 Luna、Terra、Sol 三个模板是否与仓库模板完全一致且绝不修改任何文件sh $plugin_dir/scripts/install-agents.sh --check这个脚本是失败即关闭fail-closed设计遇到被修改过的、符号链接或冲突的目标文件会直接拒绝并报告绝不覆盖。养成先检查、再开工的习惯可以杜绝 90% 的智能体配置漂移问题。技巧4主会话必须是 Sol / High否则停下来这是最容易踩的坑编排技能无法自己切换主会话的模型。如果主会话不是 GPT-5.6 Sol 高推理档位整个流水线的质量就没有保证。正确做法是开始新任务后先确认当前模型如果运行时元数据不暴露模型信息就直接让用户确认。不要在未确认的情况下假设前提成立——这是 SKILL.md 中Confirm the primary session一节的硬性要求。另外别忘了新安装智能体后要开启新任务因为原生智能体类型是在任务创建时发现的旧任务看不到新角色。技巧5用一段话显式调用编排技能想让 Codex 走完整流程不必手动拆解每个步骤直接显式调用技能即可Use $sol-advisor:orchestration to build this feature, verify it, and obtain the fresh Sol review before reporting done.这句话把构建 → 验证 → 新鲜 Sol 审查整条链路都挂上了钩子。技能的显示信息定义在 openai.yaml它告诉 Codex 何时推荐这套工作流。技巧6规格书必须写满五个部分 Sol Advisor 规定每一份交给工人的实现任务都必须包含五个标准部分——OBJECTIVE可观察的目标和它为什么重要FILES AND OWNERSHIP工人只拥有哪些文件且提醒你不是代码库里唯一的编辑者INTERFACES必须保持兼容的签名、类型、命令或行为CONSTRAINTS仓库惯例、安全边界、明确排除的范围VERIFICATION要运行的确切命令和预期的成功证据完整模板见 role-contracts.md 的Shared implementation contract一节。新手最常见的失败不是代码写错而是规格书缺了 VERIFICATION 部分导致验收无从谈起。技巧7默认走 Luna 常规通道别一开始就上重量级 判断原则很简单边界清晰、规格完整 → Luna需要大量判断、高风险、影响面大 → Terra。日常任务默认路由到 LunaMax 推理档。不要出于保险心理把所有任务都丢给 Terra——那会浪费更强的推理预算也让升级失去信号价值。Luna 模板中的指令明确要求它暴露模糊性而不是重新设计架构所以放心把常规工作交给它。技巧8一次修正尝试就是升级信号 这是 Sol Advisor 最精妙的升级规则如果 Luna 修正一次后仍失败说明任务被误判为常规任务了此时应带着修正后的规格书升级到 Terra / High 通道而不是第三次、第四次用同样的提示词重试 Luna。规则很明确任务错了 → 修正规格书给同一个通道一次有界修正一次修正暴露出误分类 → 升级到 Terra绝不用完全不变的提示词重复提交也不允许静默换模型、换角色来绕过失败技巧9永远不要相信工人自报的完成 ️技能文档原话是Treat worker reports as claims.把工人的报告当作声明。主会话验收时必须亲手做四件事检查实际的工作树和完整 diff确认只有规格范围内的文件被改动在主会话里重新运行验证命令把证据与目标、接口、约束逐条比对然后通过 inspect-agent-runtime.sh 传入子智能体线程 ID只读取白名单内的路由字段角色、模型、推理档位、沙箱策略验证说走 Luna 的真的是 Luna。该脚本遇到缺失、冲突或不一致的元数据会直接拒绝绝不推测兜底。技巧10新鲜 Sol 审查不可跳过且改完必须再审 验证通过后必须生成一个全新上下文的审查者fork_turns: none它会返回三种裁决之一ship可以交付附上验证证据fix-first委派修正 → 重新验证 →必须再审一次rethink架构需要推倒重来不得报告完成三条铁律值得贴在屏幕边审查者永不自己修 bug任何修正都会使旧裁决失效Sol 审 Sol是上下文隔离而非跨模型族的独立。附赠用 verify.sh 自检整个流水线 如果你怀疑本地环境哪里出了问题仓库内置了一整套自检脚本 verify.sh它会验证三个角色 TOML 的模型/档位锁定是否精确、安装器的幂等性与拒绝行为、运行时检查器的安全边界甚至文档中的路由措辞是否与代码一致。跑一遍全绿你的 Sol Advisor 环境就处于可信状态。写在最后Sol Advisor 的哲学可以浓缩成一句话架构判断留在主会话实现工作交给对应能力的工人验收靠自己动手最终裁决交给全新的眼睛。10 个技巧里最值钱的是技巧 6、8 和 10——规格书五要素、一次修正即升级、新鲜审查不可跳过。把这三点刻进肌肉记忆你就真正掌握了多智能体 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),仅供参考