Opencode Controller

Opencode Controller 是什么

这是 Opencode 的控制流程，不直接写代码，而是通过会话、模型与 Agent 模式切换来组织编码工作。

适用场景

适合在 Opencode 中创建或恢复会话、选择模型、先规划后构建，并持续迭代直到满足要求。

核心能力与工作机制

清单规定预检、会话管理、/agents 模式切换、模型选择、Plan 行为、Build 行为和完成报告格式。

执行流程

先确认 Opencode 可用和认证状态，创建或选择会话；进入 Plan Agent 形成方案并让用户确认，再切换 Build 执行，按结果反复 Plan—Build。

输入与输出

需要任务目标、仓库上下文、目标会话、模型偏好和用户确认的计划。输出 Opencode 命令、会话状态、计划和编码 Agent 的最终结果。

依赖、账号与权限

依赖已安装并认证的 Opencode，以及支持斜杠命令的交互环境。

副作用、限制与风险

选择错误会话或 Agent 可能在错误仓库执行；自动循环也可能放大未经确认的计划。会控制外部编码 Agent，后者可能修改文件、运行命令和产生费用。

不适用边界

控制器本身不写代码，也不能在认证或计划未确认时继续构建。

失败处理与验收

命令或认证失败时停在当前阶段，检查会话和模型可用性；不要跳过 Plan 直接让 Build 猜测。检查 Opencode 会话、实际文件差异、测试和用户要求，确认 Plan 与 Build 结果一致。

适合谁使用

适合使用 Opencode 进行结构化 Agent 编码的开发者。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Opencode Controller 主要解决什么问题？

这是 Opencode 的控制流程，不直接写代码，而是通过会话、模型与 Agent 模式切换来组织编码工作。适合在 Opencode 中创建或恢复会话、选择模型、先规划后构建，并持续迭代直到满足要求。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要任务目标、仓库上下文、目标会话、模型偏好和用户确认的计划。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先确认 Opencode 可用和认证状态，创建或选择会话；进入 Plan Agent 形成方案并让用户确认，再切换 Build 执行，按结果反复 Plan—Build。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖已安装并认证的 Opencode，以及支持斜杠命令的交互环境。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会控制外部编码 Agent，后者可能修改文件、运行命令和产生费用。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

控制器本身不写代码，也不能在认证或计划未确认时继续构建。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

命令或认证失败时停在当前阶段，检查会话和模型可用性；不要跳过 Plan 直接让 Build 猜测。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

检查 Opencode 会话、实际文件差异、测试和用户要求，确认 Plan 与 Build 结果一致。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。