核心用法
easy-opencode 是一种将代码任务完全外包给 Opencode 云端服务的编排型技能。其核心设计理念是:任何代码相关问题均交由 Opencode 处理,本地仅负责传递指令、消化结果并决策下一步动作。
技能采用严格的 Plan → Build 循环 工作流:
- Plan Agent:通过
opencode run --agent plan启动,负责需求分析、制定步骤化执行计划,并允许澄清式提问;此阶段禁止代码生成 - Build Agent:通过
opencode run --agent build启动,负责将已确认的计划转化为实际代码 - 关键约束:Build 阶段若出现任何疑问,必须立即切回 Plan 阶段处理,严禁在 Build 中直接回答问题
显著优点
1. 零成本计算:明确声明 Opencode 端费用全免,大幅降低开发成本
2. 流程标准化:强制分离"规划"与"构建",避免边想边写的混乱模式
3. 责任边界清晰:本地系统仅做"传声筒"与"决策器”,复杂逻辑由云端专业 Agent 处理
4. 持续会话:--continue 参数支持上下文保持,适合多轮迭代
潜在缺点与局限性
1. 外部依赖风险:核心功能完全绑定 Opencode 服务可用性,若服务中断则技能失效
2. 网络延迟敏感:每次 Plan/Build 均需云端往返,复杂项目可能产生显著等待时间
3. 上下文黑箱:无法洞察 Opencode 内部推理过程,调试困难
4. 灵活性受限:严格的阶段锁死("Never skip Plan")可能拖简单任务的后腿
5. 数据隐私隐患:代码需上传至第三方云端处理,敏感项目需谨慎评估
适合人群
- 预算有限的个人开发者或小团队
- 需要结构化开发流程、但缺乏架构经验的新手程序员
- 希望快速原型验证、愿意牺牲一定可控性的敏捷团队
常规风险
- 供应商锁定:深度整合后迁移成本高昂
- 计划-构建脱节:Plan 输出若存在歧义,Build 阶段可能产生偏差代码,需多轮修正
- 响应延迟不可控:依赖 Opencode 服务端负载,高峰时段可能卡顿