adviser

Adviser 是一个用于 Codex 智能体的审查路由技能，其核心目的是在任务的关键决策点引入一个独立的、仅做审查的评审代理，并将其路由到严格更强的模型层级或推理强度，从而获得独立的第二意见，而由主代理继续负责执行。需要明确的是，该技能模拟的是原生 Advisor 的决策模式，而不是其服务端实现；它使用用户定义的升级策略，并且在无法证明请求路由在该策略下更强时采取失败关闭。它不保证后端真正遵守了请求的路由、完整对话传递、同轮次子推理、原生用量计费、提示缓存行为或 Advisor 界面。\n\n用途与定位\n该技能适用于需要在长流程、多重决策或多步骤任务中获得独立战略审查的场景。文档建议在以下情况优先考虑咨询：长期多步骤工作、有重大影响或含义模糊的选择、反复出现的失败，以及独立的完成检查；而应跳过短小的机械任务，以及每一步都确实需要使用最强主模型的工作。典型的高价值检查点有两个：一是完成定位之后、选择方案之前；二是完成验证之后、宣布完成之前。这些是模型驱动的默认建议，并非固定配额或强制的两次调用规则；用户也可以明确要求先咨询再继续，或跳过 Adviser。\n\n路由机制\n使用前需先解析调用方当前有效的模型与推理强度，然后严格应用路由表中的一行，不得推断别名、静默继承调用方配置、降低推理强度或替换未列出的模型。路由表以调用方模型与强度为输入，输出评审代理的模型与强度。例如 gpt-5.6-luna 在各强度下均路由到 gpt-5.6-sol 的相同强度；gpt-5.6-terra 在各强度下同样路由到 gpt-5.6-sol 的相同强度，其中 terra 在 ultra 强度下映射到 sol 的 ultra；gpt-5.6-sol 在 low 到 medium、medium 到 high、high 到 xhigh、xhigh 到 max、max 到 ultra 均为提升一档；而 gpt-5.6-sol 的 ultra 则标记为不可用。gpt-5.6-sol/ultra 被定义为上限。若出现未知模型、未知强度、目标不可用或已达上限，则不属于 Adviser 咨询，应报告没有严格更强的路由可用，并仅在有用时使用单独的第二遍自我审查作为回退。\n\n工作流程\n第一步是在咨询前进行定位：阅读任务并收集评审代理所需的最低限度证据。文件发现、来源检索和检查当前状态属于定位；而编辑、承诺某一种解释以及宣布完成属于实质性工作。第二步是判断在当前决策点咨询是否增值。第三步是构建评审包，包含用户目标、约束、已检查的事实与相关工具结果、当前假设、拟议决策、未决问题、验证计划，并在完成时附上变更产物、差异摘要、测试结果和已知风险；须排除机密信息和无关的对话内容。第四步是解析本技能的文件系统目录为 <skill-dir>，运行 python3 <skill-dir>/scripts/route_adviser.py 来解析调用方当前轮次的 turn_context 并选择路由表中的行；只有在测试中或运行时以权威方式提供了两个值时才显式传入 --model 和 --effort。rollout JSONL 是 Codex 的内部格式，如果缺失、有歧义、格式错误或不受支持，应停止 Adviser 路径。第五步是生成一个全新的评审代理，尽可能继承最完整的对话（fork_turns: "all"），使用已路由的模型与强度，并在生成工具同时暴露两个路由字段时显式传入评审包；否则将评审包通过管道传给 python3 <skill-dir>/scripts/run_adviser.py，由后者启动一个临时的、只读的 Codex 评审器，并采用所选路由。不得使用未固定路由的生成作为回退。\n\n评审代理的指令与顾问提示契约\n应指示评审代理仅返回评论文本，不得编辑文件、运行命令、生成代理、调用另一个 Adviser 或接管任务。不得声称它收到了完整对话：压缩、fork 限制或显式限定的评审包都可能移除上下文。建议使用有边界的提示词：让评审代理充当独立的、仅审查的战略评审者，只返回评论文本，审查所提供的评审包与可继承的上下文，识别错误假设、遗漏约束、证据冲突、可能的失败模式以及最佳下一步方案，要求具体简洁，区分有证据支持的发现与不确定性，并以推荐、关键风险、证据冲突和完成检查结尾。在完成门禁处，将“最佳下一步方案”替换为请求其判断结果是否可以报告为完成，并仅列出可操作的缺口。\n\n权衡建议与冲突处理\n需要权衡建议，采纳有用的推荐，但当建议缺乏支持并与仓库证据、一手来源或实证结果冲突时，应优先后者。若证据指向一方而评审代理指向另一方，应尽可能向同一评审代理发送一次后续询问，让其为自己确切的主张辩护或修正；说明冲突并询问哪个约束可以打破平局。只有在原评审代理不可用时，才使用新的已路由评审代理。不得静默切换方向，也不要为细小的分歧反复循环。当出现实质性歧义阻碍决策、同一失败反复出现、方案不再收敛或正在考虑实质性不同的方案时，应再次咨询。在宣布实质性工作完成之前，应使交付物持久化并运行相关验证；当独立完成检查有价值时再次咨询；修复可操作的发现后，只重新运行受这些修复影响的检查。\n\n回退与最终报告\n如果路由或全新代理执行不可用，则使用同一契约执行一次清晰分离的第二遍审查，声明更强的模型独立性不可用，并且不要暗示运行了 Adviser 咨询。最终报告应包含咨询的次数与时机、调用方路由、请求的 Adviser 路由、运行时是否验证了有效路由、被采纳或拒绝的重要建议、上下文传递限制、验证状态以及顾问驱动更改后重新运行的检查，以及任何剩余风险或降级回退。没有运行时证据，不得将请求的路由报告为已验证有效；也不得仅为形式而重新运行未更改的检查。关于平台、收费、价格或可用性等未在资料中提供的事实，暂未提供。