AgentSkillsCN

invoke-opencode-acp

当文件修改次数达到 2 次及以上，或需要执行批量操作时，可将复杂任务委派给 OpenCode 子代理。

SKILL.md
--- frontmatter
name: invoke-opencode-acp
description: Delegate complex tasks to OpenCode subagent, use when >=2 file modifications or batch operations
allowed-tools: Bash

invoke-opencode-acp

When to Use

  • •Triggers: >=2 file modifications / refactor / batch ops / code review / multi-step reasoning / git ops
  • •Avoid: single-file quick edits / recursive OpenCode calls

Core Intent

  • •Save tokens (50-90%) / main model decides / subagent executes details

Efficiency Priority

  • •acp_client.cjs (this dir) > manual protocol
  • •opencode acp > run/serve (avoid HTTP)

Constraints

  • •Default sandbox blocks writes to ~/.config/opencode and ~/.cache/opencode and blocks network
  • •First run plugin install ~30s; acp_client.cjs default SESSION_TIMEOUT=10s
  • •Fix: run acp_client.cjs outside sandbox to allow ~ writes and network; or install once then retry; or raise SESSION_TIMEOUT > 30s
  • •Evidence: ~/.local/share/opencode/log/*.log records bun add/install and duration

Workflow

  1. •Pick timeout: simple >=180s / medium >=600s / complex >=1800s
  2. •If first run or PermissionDenied/Timeout(10000ms) -> retry non-sandbox or install then retry
  3. •Run:
bash
node ~/.claude/skills/invoke-opencode-acp/acp_client.cjs "$PWD" "task description" -o /tmp/output.txt -t 300
  1. •Listen session/update -> drop <thinking> -> result.stopReason === 'end_turn'
  2. •Return: OK / Timeout:{reason} / Error:{reason}

Protocol Notes

  • •initialize -> session/new(cwd,mcpServers:[]) -> session/prompt(prompt:[] shape)
  • •Error codes: -32001 not found / -32002 rejected / -32003 state / -32601 method / -32602 params

Dependencies

  • •Node.js
  • •OpenCode CLI: npm install -g opencode