OpenCode 自定义 Skills 开发实战

Skill 是什么

Skill 是 OpenCode 的可执行脚本——用 Markdown 编写，包含步骤、命令和判断逻辑。AI 读取后自动执行。

第一个 Skill：项目初始化

# init-astro-project.md

## 创建 Astro + Tailwind 项目

### 步骤
1. 在指定目录创建 Astro 项目：
   ```
   npm create astro@latest \$PROJECT_NAME -- --template minimal
   ```
2. 安装依赖：
   ```
   cd \$PROJECT_NAME && npm install tailwindcss @tailwindcss/vite
   ```
3. 配置 astro.config.mjs 添加 Vite 插件
4. 创建 src/styles/global.css，导入 Tailwind
5. 创建基础组件：Header、Footer、BaseLayout
6. 运行 `npm run dev` 验证

使用时：

@skill:init-astro-project PROJECT_NAME=my-blog

进阶 Skill：自动化部署

# deploy-cloudflare.md

## 部署到 Cloudflare Pages

### 前置条件
- 项目中有 wrangler.toml
- CLOUDFLARE_API_TOKEN 已设置

### 步骤
1. 构建项目：`npm run build`
2. 读取 wrangler.toml 获取 project_name
3. 执行部署：`npx wrangler pages deploy dist --project-name=\$PROJECT_NAME`
4. 从输出中提取部署 URL
5. 输出结果确认

Skill 设计原则

1. 单一职责：一个 Skill 只做一件事
2. 参数化：用 $VARIABLE 语法支持动态参数
3. 幂等性：重复执行不会出错
4. 验证步骤：每个关键步骤后验证结果
5. 错误处理：明确的失败提示和回退方案

实际收益

封装了 5 个常用 Skill 后，我每次部署新站点的时间从 20 分钟降到 2 分钟（AI 自动执行，我只需确认结果）。

Skills 的本质是把你的经验编码为 AI 可执行的流程——这是 AI 辅助开发从”对话”到”自动化”的关键一步。