OpenCode 入门指南：AI 辅助编程的最佳实践

OpenCode 是什么

OpenCode 是 WorkBuddy 生态中的 AI 编程代理。它不是简单的代码补全工具，而是一个能理解项目上下文、执行命令、修改文件、创建复杂应用的 AI 工程师。

核心能力

• 代码生成：根据自然语言描述生成完整功能
• 项目重构：理解现有代码结构后进行修改
• 依赖管理：自动安装和配置 npm/pip 包
• 调试修复：读错误日志、定位问题、应用修复
• 文档生成：从代码生成文档，从需求生成代码

基本用法

# 启动 OpenCode
opencode

# 自然语言指令
> 帮我创建一个 Astro 博客项目
> 把首页的配色从红色改成蓝色
> 修复这个 TypeScript 类型错误
> 把这个组件重构为 Tailwind 样式

效率提升策略

1. 先给上下文：让 AI 读完相关文件再操作
2. 分步指令：复杂任务拆成多个小步骤
3. 指定约束：明确告知框架版本、代码风格
4. 及时验证：每次修改后要求构建测试

自定义 Skills

Skills 是 OpenCode 的扩展机制，你可以把重复的工作流封装为 Skill：

# deploy-blog.md
## 部署博客到 Cloudflare
1. 运行 `npm run build`
2. 用 `npx wrangler pages deploy dist` 部署
3. 验证线上 URL 可访问

调用时只需 @skill:deploy-blog，AI 按步骤执行。

与 Cursor / Claude Code 的区别

• Cursor：IDE 插件，侧重代码补全和聊天
• Claude Code：终端工具，适合代码审查和重构
• OpenCode：全能代理，项目管理 + 代码 + 部署一条龙

OpenCode 真正改变开发方式的地方在于——它不只是帮你写代码，而是帮你完成整个开发任务。