关于 opencode-runner
opencode-runner 是一项指导安全、经批准后手动调用 OpenCode CLI 的技能。它强调限定范围的只读审查,并将每次运行视为外部模型调用;不提供可执行包装器。
主要功能
- 01手动调用 OpenCode CLI
- 02运行前检查范围与安全性
- 03只读审查和规划指导
- 04规范运行结果摘要
适用场景
- 01使用 OpenCode 审查代码库
- 02手动比较 OpenCode 的输出
- 03在主机 Agent 修改前规划实现
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ robsonrung/ rar-skills --skill opencode-runner安装后在 Claude Code 中输入/opencode-runner确认已加载。
附带文件agents/openai.yaml
详细介绍
OpenCode Runner
将此技能用作安全的 OpenCode 交接指南。本软件包有意不提供可执行的 OpenCode 包装器。
原生路由
选择外部路由前,请先阅读 shared/references/host-model-execution.md。如果当前宿主可以在原生子 Agent 或任务线程中,按要求的工作量、隔离方式和回执策略调度所选的确切模型,请使用该路由。agents/openai.yaml 是宿主 UI 元数据,不会调度原生模型。
路由限制
此库中没有 OpenCode 执行器封装。由于没有可供启动器验证的 model_receipt,因此 OpenCode 不能作为获准的实现或审查路由。仅将其用于经过人工批准的对比。将请求的提供方和模型报告为配置,而非实际执行该次运行的模型证明。
安全模型
OpenCode 可以读取项目文件,并将提示词上下文发送给已配置的模型提供方。每次运行都应视为一次外部模型调用。
运行 OpenCode 前:
- 确认用户要求使用 OpenCode,或当前工作流明确选择了它。
- 确认工作目录和提示词范围。
- 优先使用只读审查或规划提示词。
- 避免附加机密、凭据、私钥、令牌或无关文件。
- 使用宿主 Agent 正常的 Shell 审批、沙箱和日志流程来运行命令。
如果用户要求无人值守地编辑,请说明此技能不提供无人值守包装器。请改用常规的、经宿主批准的命令。
手动调用模式
通过上述检查清单后,直接在目标仓库中运行本地 OpenCode CLI。将命令范围限定得尽可能小,并传入简洁的提示词。通过常规宿主工具输出捕获 stdout 和 stderr。
opencode run "<concise prompt>"
opencode run -m <provider/model> "<concise prompt>"
opencode run --agent plan "<concise review prompt>"
对于审查任务,仅要求 OpenCode 进行分析;上面的 plan Agent 变体可确保运行保持只读。对于实现任务,先要求 OpenCode 提供补丁计划,再通过主宿主 Agent 应用更改。
输出约定
返回简短摘要,包含:
- OpenCode 命令的范围
- 主要结果
- 讨论的文件或区域
- 任何不确定之处、失败情况或缺失的前提条件
如果在跨运行器工作流(例如 models-consensus 或 council)中担任一个席位,请将同一摘要原样返回给负责协调的技能。
缺少前提条件
如果未安装 OpenCode 或未完成身份验证,请报告缺少的前提条件并停止。不要通过此技能提供安装命令。