核心用法
opencode-acp-control 是一个纯指令型 Agent Skill，旨在通过 Agent Client Protocol (ACP) 让其他 AI Agent（如 Claude）直接控制 OpenCode 终端应用。它基于 JSON-RPC 2.0 协议，以 Markdown 文档的形式提供了一套完整的操作流程，覆盖了从启动 OpenCode 后台进程、初始化连接、创建会话到发送提示词、轮询获取流式响应以及取消请求的全生命周期管理。此外，该 Skill 还包含会话恢复和自动更新检查等高级功能，使得多 Agent 协作或 AI 驱动的开发流程自动化成为可能。
显著优点
1. 协议标准化：基于公开的 ACP 协议和 JSON-RPC 2.0 标准，交互逻辑透明清晰，易于集成与调试。
2. 文档透明且零依赖：作为纯 Markdown 指令文档，不包含任何可执行代码、无依赖项、无隐藏网络调用或数据收集，用户可根据文档内容进行完全审查。
3. 功能完整：从启动、会话管理到错误处理、轮询策略的细节一应俱全，尤其是会话持久化和自动更新部分，为自动化流程提供了极高的可靠性。
4. 架构灵活：该 Skill 本身不绑定实现，Agent 可以灵活调用底层的 bash 和 process 工具来完成自动化操作。
潜在缺点或局限性
1. 来源依赖度较低：该 Skill 来自个人开发者（T3 来源可信度），其维护和长期演进存在不确定性，不如大型组织维护的项目稳定。
2. 手动更新风险：文档在自动更新失败时会建议用户使用 curl | bash 执行远程脚本，这是典型的不安全实践，普通用户若盲目执行可能面临供应链攻击风险。
3. 仅限受控环境：作为纯指令文档，它的有效性完全取决于宿主 Agent 的执行能力和环境，在受限或沙箱化的运行环境下可能无法正常使用。
适合的目标群体
- 高级用户及 AI 集成开发者：需要在更大的自动化脚本或多 Agent 系统中集成 OpenCode 功能的用户。
- AI 工作流构建者：希望通过 Agent 套娃或工具链编排来提升开发效率的团队。
- 对 OpenCode 有一定了解的用户：该 Skill 更适合那些已在使用 OpenCode 并希望升级其控制方式的用户。
使用该技能可能存在的常规风险
- 性能及资源管理：每次交互启动新的后台进程并维持轮询，对系统资源有一定占用，长期运行需注意进程泄漏。
- 时间成本与稳定性：轮询机制的最大等待时间长达 5 分钟，网络或 Agent 状态波动可能导致任务超时。
- 安全风险：虽然 Skill 自身无害，但使用者通过它执行的具体命令或生成的代码可能存在安全漏洞，需对最终产出进行审查。此外，其建议的
curl | bash手动操作对非专业人员构成潜在威胁。