ACP 协议控制开发助手

通过标准化 ACP 协议远程操控 OpenCode，实现会话管理、消息收发与自动更新，提升 AI 编程助手集成效率。

基本信息

• 技能名称?Opencode Acp Control
• 中文名称?ACP 协议控制开发助手
• 作者?bjesuiter
• 分类?专业技能
• 版本?1.0.2
• 标签?development-engineering, automation, devops, productivity

使用方法

使用说明
核心用法
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 工具来完成自动化操作。
   潜在缺点或局限性
5. 来源依赖度较低 ：该 Skill 来自个人开发者（T3 来源可信度），其维护和长期演进存在不确定性，不如大型组织维护的项目稳定。
6. 手动更新风险 ：文档在自动更新失败时会建议用户使用 curl | bash 执行远程脚本，这是典型的不安全实践，普通用户若盲目执行可能面临供应链攻击风险。
7. 仅限受控环境 ：作为纯指令文档，它的有效性完全取决于宿主 Agent 的执行能力和环境，在受限或沙箱化的运行环境下可能无法正常使用。
   适合的目标群体
   高级用户及 AI 集成开发者 ：需要在更大的自动化脚本或多 Agent 系统中集成 OpenCode 功能的用户。
   AI 工作流构建者 ：希望通过 Agent 套娃或工具链编排来提升开发效率的团队。
   对 OpenCode 有一定了解的用户 ：该 Skill 更适合那些已在使用 OpenCode 并希望升级其控制方式的用户。
   使用该技能可能存在的常规风险
   性能及资源管理 ：每次交互启动新的后台进程并维持轮询，对系统资源有一定占用，长期运行需注意进程泄漏。
   时间成本与稳定性 ：轮询机制的最大等待时间长达 5 分钟，网络或 Agent 状态波动可能导致任务超时。
   安全风险 ：虽然 Skill 自身无害，但使用者通过它执行的具体命令或生成的代码可能存在安全漏洞，需对最终产出进行审查。此外，其建议的 curl | bash 手动操作对非专业人员构成潜在威胁。