OpenCode AI

核心用法

OpenCode 是 Cursor/Windsurf 的终端替代品，通过 opencode run 执行 AI 驱动的编码任务。核心模式包括：

快速任务（One-Shot）：opencode run "任务描述" 直接运行单次任务，支持 -f 附加文件上下文、-m 指定模型（如 anthropic/claude-sonnet-4）、--continue 续接会话。

交互式 TUI：运行 opencode 进入终端界面，通过 /agents 切换智能体：

• plan 智能体：分析设计（只读不修改）
• build 智能体：执行代码实现
• explore 智能体：代码库探索

推荐工作流：Plan → Build 分离，先规划后实施。

GitHub 集成：opencode pr 123 自动 checkout PR 并启动审查修复。

显著优点

1. 会话持久化：支持 --session 管理多会话、--fork 分叉会话、--share 生成分享链接
2. 模型灵活：支持多提供商模型，含 high/max/minimal 推理强度调节
3. MCP/ACP 生态：集成 Model Context Protocol 和 Agent Client Protocol 扩展能力
4. 成本透明：opencode stats 查看 Token 用量与费用

局限性与风险

⚠️ 智能体切换限制：--agent 参数在 run 模式中被忽略，仅 TUI 内 /agents 有效
⚠️ 目录依赖：需确保 /usr/sbin 在 PATH 中以支持 sysctl 架构检测
⚠️ 版本信息不一致：文档标注 v1.3.9，元数据为 v1.2.2，存在维护疏漏
⚠️ 功能边界：官方明确区分——简单单行编辑应使用原生 edit 工具，避免过度调用

适合人群

• 习惯终端工作流、需要 Cursor 级 AI 能力但拒绝 GUI 的开发者
• 需批量处理多文件重构、PR Review、代码探索的工程师
• 追求会话可复现、可分享的可追溯开发场景

常规风险

• 外部依赖风险：OpenCode 本身需独立安装，Skill 仅提供调用封装，实际安全取决于 OpenCode 二进制
• API 成本失控：高频调用 AI 模型可能产生意外费用，建议配合 --variant minimal 和 stats 监控
• 会话数据残留：--share 功能可能将代码片段上传至云端，敏感项目需谨慎

核心功能与用法

OpenCode 是一款 AI 原生的终端代码编辑器（CLI/TUI 版本），类似 Cursor 或 Windsurf 的命令行形态。该 Skill 为其 OpenClaw 集成封装，主要提供：

核心用法：

• 快速任务模式：opencode run "任务描述" 支持单条 AI 指令执行，可附加文件上下文（-f）、指定模型（-m）、继续会话（-c）等
• 交互式 TUI：直接运行 opencode 进入终端 UI，支持 /sessions、/agents、/models 等斜杠命令
• 多 Agent 协作：内置 plan（分析设计）、build（编码实现）、explore（代码探索）等 Agent，推荐 Plan → Build 工作流
• GitHub 集成：opencode pr 123 可直接检出 PR 并启动审查修复
• MCP 与插件扩展：支持 MCP 服务器管理、自定义 Agent 和插件安装

显著优点：
1. 纯文档型 Skill：仅包含 SKILL.md 说明文档和示例脚本，无实际可执行代码，100% 透明可审计
2. 零网络零依赖：Skill 本身无外部 API 调用、无依赖包，所有网络交互由用户本地 opencode CLI 独立管理
3. 功能边界清晰：明确区分 OpenCode 与 OpenClaw 原生工具（edit/read）的使用场景，避免能力混淆
4. 企业级安全评级：认证评分 98 分（S 级），通过静态分析、动态行为、隐私合规等全部 6 项安全扫描
5. 会话管理能力：支持会话共享、导出导入、分叉续接，适合复杂长周期开发任务

潜在局限：

• 依赖外部工具：必须预先安装 opencode CLI（brew install），Skill 本身不提供安装能力
• 平台限制：当前仅支持 macOS Darwin x64，Linux/Windows 用户暂无法使用
• Agent 切换限制：--agent 参数在 run 模式下无效，仅 TUI 支持 Agent 切换
• 学习成本：TUI 斜杠命令、多 Agent 协作模式需要一定学习曲线

适合人群：

• 习惯终端开发的工程师，需要 Cursor/Windsurf 级 AI 辅助但偏好 CLI 环境
• 进行多文件重构、代码库探索、PR 审查等复杂任务的开发者
• 注重工具安全透明度的企业开发团队

常规风险：

• 极低。Skill 本身无数据收集、无敏感信息访问。唯一风险点为用户本地 opencode CLI 的 API 密钥管理（由 OpenCode 自身负责，不在 Skill 控制范围内）。