Agent-Skills.md

Agent Skills: Use Other Model

>-

UncategorizedID: ruan-cat/monorepo/use-other-model

Repository

ruan-cat/monorepo
ruan-catLicense: MIT
41

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ruan-cat/monorepo/tree/HEAD/ai-plugins/common-tools/skills/use-other-model

Skill Files

Browse the full folder contents for use-other-model.

Download Skill

Loading file tree…

ai-plugins/common-tools/skills/use-other-model/SKILL.md

Skill Metadata

Name
use-other-model
Description
>-

Use Other Model

目标

把合适的任务可靠地委托给其他模型或独立 reviewer，同时保留主代理的最终责任、失败分层和可复核证据。

这是一项委托路由技能，不是第二套 agent 平台。主文件只保留稳定入口、硬边界和快速检查；任务合同、状态机、验证细节、失败分流和启动模板按需读取 references/。

核心原则

  1. 质量与确定性优先于 token 节省

    • 边界清楚、可独立验收时才委托。
    • 协调成本高于收益时，主代理直接完成。

  2. 能启动不等于能完成

    • 退出码 0、agent 自报 success、单个测试通过都不能单独证明任务完成。
    • provider/model、权限、工具错误、预期产物和独立验证必须按层核对。

  3. 执行者不能兼任最终验收者

    • 执行 agent 只能提出候选状态。
    • verifier 状态由独立只读 reviewer、确定性校验或主代理生成。
    • 人工接受状态只能由用户/人类决定。

  4. 优先最小官方命令，不扩张 launcher

    • 先运行 CLI 官方、最小、可观察的命令或 smoke check。
    • 没有原始失败证据，不新增复杂进程树、状态机、脱敏、cleanup 或自定义执行协议。

  5. 对外分发 skill 站在安装后目录视角，并且运行时自包含

    • 示例只使用技能目录内相对路径。
    • 不写本机绝对路径、开发期报告、monorepo 内部测试/CI 路径或用户私有目录。
    • 任何正常执行必需的规则、模板、失败边界、验证条件和当前设计依据，都必须位于本 use-other-model/ 目录的 SKILL.md、references/ 或 scripts/ 中。
    • 源 monorepo 的 .agents/、docs/reports/、hardening archive 和根级 AI 记忆只能作为开发期证据，不能成为独立安装后的运行时依赖。
    • 外部技术报告只允许作为可选背景；网络不可用时仍必须能从本技能目录完成正常流程。
    • 当前硬门的因果记忆见 references/design-memory.md；维护或扩展本技能时不需要回源 monorepo archive 才能理解当前设计。

什么时候委托

适合

  • 批量或多文件操作、格式转换、重复性编辑。
  • 预计超过 5 分钟且任务边界可封包的工作。
  • 可并行的独立子任务。
  • 独立验证、蓝军复核或安全审计。
  • OpenCode provider/model、默认模型、variant、headless 链路检查。
  • 需要在 MCP、Claude Code 独立会话与 OpenCode 路径之间做选择。

不适合

  • 一眼能完成的单文件短改或查询。
  • 需求仍在变化、必须频繁向用户追问的任务。
  • 无法列出读写范围、验收命令或完成条件的任务。
  • 把复杂根因、安全判断、架构取舍或最终合并决定下放给弱执行模型。

用户已经给出完整 opencode run / claude -p / skills add 命令时，默认尊重原命令，不为了“更稳”自动扩张成 wrapper、agent team、发布流程或同步 fallback。

A-D 路由

| 路径 | 适用场景 | 最低证据 | | ----------------------------- | ------------------------------------------------ | -------------------------------------------------------------- | | A：MCP 工具 | 简单任务、单次调用 | connector/tool、实际参数、真实结果 | | B：独立 Claude Code 会话 | 多步骤编码、批量操作、需要独立读写与验证 | 实际命令、工作目录、permission/tools、原始输出、退出码 | | C：OpenCode provider 模式 | 显式 provider、API key/baseURL、provider/model | provider/model/variant/session、认证链路、结构化事件、退出原因 | | D：OpenCode 默认内部模型 | 默认模型 smoke check、headless、未指定 --model | 默认选择链、variant/session、可观察到的实际模型身份、原始事件 |

硬规则：

  • C 与 D 不互相替代；显式 provider/model 走 C，默认内部模型走 D。
  • OpenCode 直启与原生临时子代理默认互斥；只有用户明确要求嵌套时才组合。
  • “模型可发现”不等于“本次 session 已选中”。同名模型需要区分 provider/model。
  • A-D 是调用路径，不代表模型强度。复杂诊断、安全审计和最终判断仍交给强模型/主代理。

详细能力合同、角色边界和身份等级见 references/delegation-contract.md。

弱执行模型硬门

弱模型只能承担已经被强主代理压平的 execution 任务，不能运行整套 skill 决策流程。

只有同时满足以下条件才允许使用弱执行模型：

  • 目标文件集合可以在启动前精确列出。
  • 修改能写成确定性的逐步动作，不需要架构、根因、安全或产品判断。
  • 验证命令已经冻结。
  • 不需要执行过程中询问用户。
  • 任意意外情况都可以安全停止并交回主代理。

强主代理必须先完成 A-D 选路、preflight、范围冻结和失败策略，再生成 Weak Executor Packet。弱执行模型收到的包必须包含 DECISION_BUDGET: 0、EXACT_ACTIONS、STOP_IF 和固定 RETURN schema。

弱执行模型禁止：

  • 自己选择 A-D、模型层级或实现方案。
  • 自己读取本 skill 的 references 来补全流程。
  • 自己扩大读写范围、换工具、换 provider/model 或安装依赖。
  • 自己恢复未预定义的失败。
  • 自己修改验收规则或写 verifier_status / human_accepted。

任何未在 packet 中明确给出答案的选择，都返回 BLOCKED，不继续推理解决。

完整弱模型合同与固定 packet 见 references/weak-executor-contract.md。

启动前固定执行卡

按顺序执行，不得跳过：

  1. 建立证据目录

    • 当前项目根目录使用 .use-other-model/task-YYYYMMDD-<slug>/。
    • .use-other-model/.gitignore 内容必须为单独一行 *。
    • context、prompt、原始输出、stderr、execution log 和派生摘要都放在该任务目录。

  2. 冻结角色与范围

    • 明确 execution / diagnostic / audit。
    • 冻结 working_directory、读写 allowlist、expected_changed_files、forbidden paths/actions、验收命令和预期产物。
    • 完整 schema 见 references/context-packet-template.md。

  3. 完成 preflight

    • 工作目录与允许路径必须真实可达；跨工作区路径必须显式列入读白名单。
    • 显式 provider 路径记录完整 provider/model；默认模型身份拿不到时保持 unknown，不猜测。
    • 只检查凭据/认证配置是否存在，不读取或记录秘密值。
    • 记录实际 permission mode、工具范围和可观察到的自动加载 skill。
    • verify_commands、测试、评分、verifier、CI 和 acceptance schema 在执行前冻结。
    • CLI 不支持 allowlist/dry-run/read-only 等能力时，记录能力缺口并用外部校验补齐，不伪造参数。

  4. 按模型能力编译执行包

    • 中/强 execution agent 可以使用完整 Task Packet。
    • 弱 execution agent 必须由主代理把完整合同压平成 Weak Executor Packet；弱模型不得自己读取 references、选路或补计划。

  5. 运行最小 smoke check

    • B/C/D 的命令模板分别按需读取对应 reference。
    • --auto 不是默认开关；只读任务不开启，写任务只有在用户明确授权、范围可枚举且可回滚时使用。

  6. 执行任务并保留原始证据

    • stdout、stderr、JSON/JSONL 原样保存。
    • 派生摘要单独保存，不覆盖或“美化”原始输出。
    • 重试不得覆盖上一轮证据。

  7. 独立验证

    • 精确比较 changed files 与 expected_changed_files。
    • 检查越界路径、秘密值、危险动作和验收规则篡改。
    • 同时核对退出码、结构化工具/权限事件、预期产物和冻结验证命令。
    • 只有 VERIFIER_PASS 才能向用户报告“候选完成”。

  8. 清理与收口

    • 只清理秘密值和明确应删除的临时凭据；证据按任务策略保留。
    • cleanup 风险独立报告，不能被前面步骤的成功掩盖。

完整 preflight、prompt 合同、状态机和 verifier 规则见：

角色边界

| 角色 | 默认模型层级 | 负责 | 不负责 | | ------------ | ------------ | ------------------------------- | ---------------------------------- | | 主代理 | 强 | 规划、复杂根因、整合、最终验收 | 不外包完成声明与合并决定 | | 执行型子代理 | 弱/中 | 明确 diff、批量操作、按清单执行 | 不扩需求、不做架构/根因/安全签字 | | 诊断协作者 | 强 | 独立采证、候选假设、复现 | 不替主代理定案 | | 审计型子代理 | 强且独立 | 冻结工作树后的只读复核 | 不修改实现、不沿用执行者结论当证据 |

补充：弱 execution agent 只能使用 Weak Executor Packet，decision_budget = 0；诊断、审计、路由、preflight 与最终验收不得下放给弱模型。

推荐顺序：

主代理冻结范围 → 编译执行包 → 执行/诊断取证 → 主代理整合 → 工作树冻结 → 独立审计 → 主代理最终验收

方案 B 的额外硬边界

方案 B 是 unattended coding agent，不是普通问答会话：

Launcher 复杂度红线

一次性 launcher 只负责准备路径、调用 CLI、保存真实输出、返回退出码。出现以下任一迹象先停下：

  • 为一次 CLI 调用新增大量函数或复杂进程树治理。
  • 无直接命令失败证据就引入 ProcessStartInfo、异步管道、手工引号协议或自定义状态机。
  • launcher 自己伪造 result.json 的 success/blocked/partial 状态。
  • 把脱敏、批量 kill、cleanup、长期状态写入 launcher。
  • 把 ANTHROPIC_MODEL 当成所有 Claude Code 任务的通用硬门禁。

只有“标准模板已真实失败 + 原始 stdout/stderr/退出码可复现 + 新代码与失败证据一一对应”时，才允许突破红线。

失败与重试

失败必须先分层，再处理：

  • PREFLIGHT_BLOCKED
  • CLI 启动失败
  • provider/auth 失败
  • tool/permission 失败
  • task execution 失败
  • artifact/verifier 失败
  • browser verification 失败
  • cleanup 风险

同一任务最多一次失败重试，且必须改变失败层或输入条件，例如先修正路径/权限后再重试。相同命令、上下文和权限条件下原地轮询属于无效重试，主代理接管。

弱模型例外更严格：只有 packet 已经预定义具体失败信号与下一动作时，弱模型才可执行一次固定恢复；任何未预定义失败立即 BLOCKED，不得自行换方案。

详细信号、第一动作和回退规则见 references/failure-routing.md。

预算

任务封包记录时间预算；能获取真实 token 消耗时同时记录 token budget/usage，获取不到写 unavailable。

  • 简单：5 分钟以内
  • 中等：10–20 分钟
  • 复杂：20–45 分钟
  • 预计超过 45 分钟：先拆任务

预算不足不能成为放宽 write allowlist、关闭 verifier 或重复同参数重试的理由。

安全边界

  • 不在 prompt、context、日志或结果中复制 API key、认证 header、私有 token；只引用环境变量名。
  • 执行 agent 不修改测试、评测、评分、verifier、CI 或 acceptance schema 来让自己通过，除非这些文件本身就是用户明确目标且另有独立验收。
  • 不自动 commit、push、发版、部署、数据库迁移、生产运维、长期记忆写入或外部任务状态修改，除非用户明确授权并由对应专门流程处理。
  • 不默认访问兄弟工作区、用户目录或全盘文件。
  • 前端任务不能用 build/test 替代浏览器验收；浏览器不可用时明确标记 blocked。

最小验收清单

  • [ ] 工作目录、路径、模型身份、权限和验收规则在调用前已冻结。
  • [ ] 跨工作区不可达时在模型调用前得到 PREFLIGHT_BLOCKED。
  • [ ] 弱模型任务满足 weak-executor 适用门槛，且实际收到 DECISION_BUDGET: 0、EXACT_ACTIONS、STOP_IF 和固定 RETURN schema。
  • [ ] 弱模型没有自行读取 references、选 A-D、扩 scope、换 provider/model 或恢复未预定义失败。
  • [ ] 退出码 0 但存在权限拒绝、工具错误、缺失产物或 verifier 失败时，没有标成功。
  • [ ] changed files 精确匹配预期集合且全部位于 write allowlist。
  • [ ] 原始 stdout/stderr/JSONL 独立可复核，派生摘要未覆盖原始证据。
  • [ ] 执行者没有写 verifier_status / human_accepted，也没有改冻结验收规则。
  • [ ] 重试最多一次且改变失败条件；弱模型只执行预定义恢复。
  • [ ] 主代理亲自查看最终 diff，并完成与任务风险匹配的独立验证。

完整状态机和确定性检查见 references/evidence-verification.md。

按需读取

  • 弱执行模型编译 → references/weak-executor-contract.md
  • A：MCP → references/method-a-mcp-tools.md
  • B：Claude Code 独立会话 → references/method-b-independent-session.md + references/claude-code-launch-templates.md
  • C：OpenCode provider → references/opencode-provider-launch-templates.md
  • D：OpenCode 默认/headless → references/opencode-headless-launch-templates.md
  • 任务封包 → references/context-packet-template.md
  • 失败分流 → references/failure-routing.md
  • 独立验证 → references/evidence-verification.md
  • 前端浏览器验收 → references/frontend-browser-verification-template.md
  • 环境变量识别 → references/environment-variables.md
  • 维护/设计原因 → references/design-memory.md
  • 案例与背景 → references/case-study-git-commits.md、references/technical-reports.md
  • 完整 reference 导航 → references/README.md