尧图网站建设 
如何写出AI编排技能Sol Advisor SKILL.md逐行精讲编排逻辑【免费下载链接】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 复审者验收。它的核心编排逻辑全部写在一份技能文件 SKILL.md 里仅 185 行。本文带你逐节精讲这份多智能体编排技能的写法并提炼出可直接复用的心法。 全局概览一条流水线、四个角色Sol Advisor 的 AI 编排模型是一条计划 → 实现 → 验证 → 复审的流水线阶段角色绑定模型职责计划Sol / High主会话gpt-5.6-sol解析意图、架构设计、任务拆解常规实现Luna / Maxgpt-5.6-luna边界清晰、规格完整的例行工作升级实现Terra / Highgpt-5.6-terra高判断密度 / 高风险 / 被误分类的工作最终复审Fresh Sol / Highgpt-5.6-sol只读沙箱审查真实 diff返回 ship / fix-first / rethink三个执行者都是原生自定义智能体模型与推理强度直接写死在角色模板里例如 sol-advisor-luna-implementer.toml 与 sol-advisor-sol-reviewer.toml。 Frontmatter技能文件的身份证SKILL.md 第 1-4 行 是 YAML 头name: orchestration给出技能名description则用一句话把默认 Luna/Max 常规实现 显式 Terra/High 升级 全新 Sol/High 复审三大机制全部声明出来。 新手常犯的错误是写一句空泛的描述。好的 AI 编排技能描述本身就是能力契约——触发技能的人和模型先读它就能知道这条流水线长什么样。 开篇定位先告诉编排者你是谁正文开头第 8-14 行 第一句就是Act as the architect扮演架构师随后明确主会话拥有五样东西用户意图、架构、拆解、完整任务规格、父级验证与最终验收。紧接着 第 16-17 行 要求第一次委托前必须先读 role-contracts.md。这一句看似不起眼却是编排质量的锚点把任务怎么写、报告怎么交的完整合同抽到独立参考文件里主技能只保留流程骨架。✅ 前置检查绝不假设主会话配置正确第 19-25 节 规定主会话必须运行 gpt-5.6-sol high 推理。元数据可查就核对不可查就问用户——只要不符停下不委托。A skill cannot change the primary model itself; never assume or claim this prerequisite is satisfied.技能无法更改主模型绝不假设前置条件已满足。这是整篇技能文件最值得抄的一句明确列出我做不到、需要用户保证的前置条件并用 stop 而不是 assume 来收尾。很多失败的 AI 编排就死在默认环境是对的。 车道选择Luna 默认Terra 显式升级第 27-49 行 定义了路由规则只有三条极其干净默认走 Luna / Max边界清晰、规格完整的工作用精确角色名sol_advisor_luna_implementer派生并固定fork_turns: none不继承历史上下文工人带着空白脑子进场。显式升级 Terra / High一开始就判定为高判断密度、高风险、上下文重载或影响面大的工作直接走 Terra 角色。一次纠正即暴露误分类 → 升级Luna 修正一次仍显示这不是例行工作就把修正后的规格转给 Terra。第 49 行补上致命一击There is no silent model, effort, role, or native-lane fallback.不存在任何静默回退。写编排技能时给每个失败分支显式定义出路模型才不会自己变通。 Preflight 四步每次委托前的安检第 51-111 行 是全文最工程化的一段把四步检查绑死在流程上模板精确性检查跑 install-agents.sh --check证明三个角色文件与出厂模板逐字节一致不一致就停掉对应车道绝不用别的模型绕过去。角色名暴露检查确认原生派生工具能列出全部三个精确角色名缺一个就提示用户装/重启任务不找近似角色顶替。运行时证据检查先读公开的 spawn 元数据缺模型/强度字段时才用 inspect-agent-runtime.sh 做本地只读回退——缺失、不一致、不可观测的路由一律停止该车道。沙箱类型留痕复审者请求只读沙箱但宿主可能放宽按观测到的隔离而非请求的隔离行事。 这套 Preflight 的本质把我凭什么相信工人是那个工人变成可执行的检查项而不是口头约定。 架构师的活留在主会话第 113-128 行 划出一条清晰的责任线主会话保留需求消歧、架构与接口、完整五段式规格、真实 diff 检查与复跑验证、裁决与验收。主会话不写实现代码、测试样板、机械配置——能派出去就别自己敲。工人做错了怎么办修正规格 → 只委托一次有边界的纠正→ 仍暴露误分类就升级 Terra。不要悄悄修好失败的补丁也不要把未解决的纠正藏起来。这一节回答了多智能体编排最常见的病架构师越权动手。 五段式任务规格给工人一份完整合同第 130-140 行 规定每条实现提示词必须包含 角色契约 中的五个板块OBJECTIVE目标与意义→FILES AND OWNERSHIP你只拥有这些文件且你不是代码库里唯一的人→INTERFACES必须保持兼容的签名/类型/命令→CONSTRAINTS仓库约定与安全边界→VERIFICATION精确命令 可观测的成功证据。两条配套铁律每个工人只领一套自有文件或一项有界职责独立不重叠的工作才并发共享文件与依赖链必须串行。给失败的车道一份修正后的规格永远不要原样重发同一个提示词。最后还要求工人按固定 IMPLEMENTATION REPORT 结构回报——没有证据的完成声明视为无效。 验证每一条实现报告只是声称第 142-151 行 把验证写成五步硬流程亲自查看工作区与完整 diff确认只有范围内文件被改动在主会话重新执行规格中的验证命令把证据与目标、接口、约束逐一比对纠正仍走同一个合适的原生角色并重复父级验证。核心思想一句话worker 的输出是 claim声称父级验证才是 fact事实。⚖️ 强制新鲜 Sol 复审ship / fix-first / rethink第 153-173 行 是全流程的最后一道闸父级验证通过后必须派生一个全新线程的sol_advisor_sol_reviewerfork_turns: none角色模板 固定只读沙箱。复审者只能输出三个判决之一ship带验证证据宣布完成fix-first委托修复 → 再次验证 → 拿一次新的复审rethink改架构不得宣布完成。两条红线复审者永远不自己修 bug任何修复都会使旧判决作废必须重跑新鲜复审。隔离按观测值执行第 175-182 行观测到read-only才算强制隔离宿主放宽、隔离不可观测或发生任何变更时停止复审并如实上报不掩饰。 提炼写出可靠 AI 编排技能的 7 条心法描述即契约frontmatter 的 description 写清角色、车道与终局别写空话。先定位再流程正文第一句定义你编排者是谁、拥有什么。前置条件 fail-stop列出技能保证不了的前提不符就停绝不 assume。车道显式化默认车道 显式升级规则 无静默回退三件套。Preflight 可执行把相信谁变成可运行的检查命令而非口头约定。合同化派工五段式规格 有界所有权 结构化的证据回报。新鲜眼复审终审者全新上下文、只读、判决三选一、改过必重审。想完整研读这些机制可对照 README.md 的Native routing与How routing works两节以及 role-contracts.md 末尾的Commitment-boundary Sol consult——同一套只读复审角色还被复用为重大架构决策前的咨询者一次角色定义、多处复用。 项目文件地图文件作用skills/orchestration/SKILL.md编排主技能本文精讲对象references/role-contracts.md三车道的完整提示词合同与回报结构sol-advisor-luna-implementer.toml常规车道角色模板Luna / maxsol-advisor-terra-implementer.toml升级车道角色模板Terra / highsol-advisor-sol-reviewer.toml只读复审角色模板Sol / highscripts/install-agents.sh角色模板安装与字节级校验scripts/inspect-agent-runtime.sh运行时路由证据的只读检查器scripts/verify.sh仓库级三角色架构自检脚本一份 185 行的 SKILL.md 之所以可信不在于篇幅而在于每一步都给了不满足时怎么办的显式出路。这正是你写自己的 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），仅供参考 如何写出AI编排技能？Sol Advisor SKILL.md逐行精讲编排逻辑
如何写出AI编排技能Sol Advisor SKILL.md逐行精讲编排逻辑【免费下载链接】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 复审者验收。它的核心编排逻辑全部写在一份技能文件 SKILL.md 里仅 185 行。本文带你逐节精讲这份多智能体编排技能的写法并提炼出可直接复用的心法。 全局概览一条流水线、四个角色Sol Advisor 的 AI 编排模型是一条计划 → 实现 → 验证 → 复审的流水线阶段角色绑定模型职责计划Sol / High主会话gpt-5.6-sol解析意图、架构设计、任务拆解常规实现Luna / Maxgpt-5.6-luna边界清晰、规格完整的例行工作升级实现Terra / Highgpt-5.6-terra高判断密度 / 高风险 / 被误分类的工作最终复审Fresh Sol / Highgpt-5.6-sol只读沙箱审查真实 diff返回 ship / fix-first / rethink三个执行者都是原生自定义智能体模型与推理强度直接写死在角色模板里例如 sol-advisor-luna-implementer.toml 与 sol-advisor-sol-reviewer.toml。 Frontmatter技能文件的身份证SKILL.md 第 1-4 行 是 YAML 头name: orchestration给出技能名description则用一句话把默认 Luna/Max 常规实现 显式 Terra/High 升级 全新 Sol/High 复审三大机制全部声明出来。 新手常犯的错误是写一句空泛的描述。好的 AI 编排技能描述本身就是能力契约——触发技能的人和模型先读它就能知道这条流水线长什么样。 开篇定位先告诉编排者你是谁正文开头第 8-14 行 第一句就是Act as the architect扮演架构师随后明确主会话拥有五样东西用户意图、架构、拆解、完整任务规格、父级验证与最终验收。紧接着 第 16-17 行 要求第一次委托前必须先读 role-contracts.md。这一句看似不起眼却是编排质量的锚点把任务怎么写、报告怎么交的完整合同抽到独立参考文件里主技能只保留流程骨架。✅ 前置检查绝不假设主会话配置正确第 19-25 节 规定主会话必须运行 gpt-5.6-sol high 推理。元数据可查就核对不可查就问用户——只要不符停下不委托。A skill cannot change the primary model itself; never assume or claim this prerequisite is satisfied.技能无法更改主模型绝不假设前置条件已满足。这是整篇技能文件最值得抄的一句明确列出我做不到、需要用户保证的前置条件并用 stop 而不是 assume 来收尾。很多失败的 AI 编排就死在默认环境是对的。 车道选择Luna 默认Terra 显式升级第 27-49 行 定义了路由规则只有三条极其干净默认走 Luna / Max边界清晰、规格完整的工作用精确角色名sol_advisor_luna_implementer派生并固定fork_turns: none不继承历史上下文工人带着空白脑子进场。显式升级 Terra / High一开始就判定为高判断密度、高风险、上下文重载或影响面大的工作直接走 Terra 角色。一次纠正即暴露误分类 → 升级Luna 修正一次仍显示这不是例行工作就把修正后的规格转给 Terra。第 49 行补上致命一击There is no silent model, effort, role, or native-lane fallback.不存在任何静默回退。写编排技能时给每个失败分支显式定义出路模型才不会自己变通。 Preflight 四步每次委托前的安检第 51-111 行 是全文最工程化的一段把四步检查绑死在流程上模板精确性检查跑 install-agents.sh --check证明三个角色文件与出厂模板逐字节一致不一致就停掉对应车道绝不用别的模型绕过去。角色名暴露检查确认原生派生工具能列出全部三个精确角色名缺一个就提示用户装/重启任务不找近似角色顶替。运行时证据检查先读公开的 spawn 元数据缺模型/强度字段时才用 inspect-agent-runtime.sh 做本地只读回退——缺失、不一致、不可观测的路由一律停止该车道。沙箱类型留痕复审者请求只读沙箱但宿主可能放宽按观测到的隔离而非请求的隔离行事。 这套 Preflight 的本质把我凭什么相信工人是那个工人变成可执行的检查项而不是口头约定。 架构师的活留在主会话第 113-128 行 划出一条清晰的责任线主会话保留需求消歧、架构与接口、完整五段式规格、真实 diff 检查与复跑验证、裁决与验收。主会话不写实现代码、测试样板、机械配置——能派出去就别自己敲。工人做错了怎么办修正规格 → 只委托一次有边界的纠正→ 仍暴露误分类就升级 Terra。不要悄悄修好失败的补丁也不要把未解决的纠正藏起来。这一节回答了多智能体编排最常见的病架构师越权动手。 五段式任务规格给工人一份完整合同第 130-140 行 规定每条实现提示词必须包含 角色契约 中的五个板块OBJECTIVE目标与意义→FILES AND OWNERSHIP你只拥有这些文件且你不是代码库里唯一的人→INTERFACES必须保持兼容的签名/类型/命令→CONSTRAINTS仓库约定与安全边界→VERIFICATION精确命令 可观测的成功证据。两条配套铁律每个工人只领一套自有文件或一项有界职责独立不重叠的工作才并发共享文件与依赖链必须串行。给失败的车道一份修正后的规格永远不要原样重发同一个提示词。最后还要求工人按固定 IMPLEMENTATION REPORT 结构回报——没有证据的完成声明视为无效。 验证每一条实现报告只是声称第 142-151 行 把验证写成五步硬流程亲自查看工作区与完整 diff确认只有范围内文件被改动在主会话重新执行规格中的验证命令把证据与目标、接口、约束逐一比对纠正仍走同一个合适的原生角色并重复父级验证。核心思想一句话worker 的输出是 claim声称父级验证才是 fact事实。⚖️ 强制新鲜 Sol 复审ship / fix-first / rethink第 153-173 行 是全流程的最后一道闸父级验证通过后必须派生一个全新线程的sol_advisor_sol_reviewerfork_turns: none角色模板 固定只读沙箱。复审者只能输出三个判决之一ship带验证证据宣布完成fix-first委托修复 → 再次验证 → 拿一次新的复审rethink改架构不得宣布完成。两条红线复审者永远不自己修 bug任何修复都会使旧判决作废必须重跑新鲜复审。隔离按观测值执行第 175-182 行观测到read-only才算强制隔离宿主放宽、隔离不可观测或发生任何变更时停止复审并如实上报不掩饰。 提炼写出可靠 AI 编排技能的 7 条心法描述即契约frontmatter 的 description 写清角色、车道与终局别写空话。先定位再流程正文第一句定义你编排者是谁、拥有什么。前置条件 fail-stop列出技能保证不了的前提不符就停绝不 assume。车道显式化默认车道 显式升级规则 无静默回退三件套。Preflight 可执行把相信谁变成可运行的检查命令而非口头约定。合同化派工五段式规格 有界所有权 结构化的证据回报。新鲜眼复审终审者全新上下文、只读、判决三选一、改过必重审。想完整研读这些机制可对照 README.md 的Native routing与How routing works两节以及 role-contracts.md 末尾的Commitment-boundary Sol consult——同一套只读复审角色还被复用为重大架构决策前的咨询者一次角色定义、多处复用。 项目文件地图文件作用skills/orchestration/SKILL.md编排主技能本文精讲对象references/role-contracts.md三车道的完整提示词合同与回报结构sol-advisor-luna-implementer.toml常规车道角色模板Luna / maxsol-advisor-terra-implementer.toml升级车道角色模板Terra / highsol-advisor-sol-reviewer.toml只读复审角色模板Sol / highscripts/install-agents.sh角色模板安装与字节级校验scripts/inspect-agent-runtime.sh运行时路由证据的只读检查器scripts/verify.sh仓库级三角色架构自检脚本一份 185 行的 SKILL.md 之所以可信不在于篇幅而在于每一步都给了不满足时怎么办的显式出路。这正是你写自己的 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），仅供参考