代理技能

# 项目本地
.opencode/skills/<name>/SKILL.md
 
# 全局
~/.config/opencode/skills/<name>/SKILL.md
 
# Claude 兼容
.claude/skills/<name>/SKILL.md

---
name: react-component
description: 生成符合规范的 React 组件
---
 
# React 组件生成规范
 
## 要求
 
1. 使用函数组件 + TypeScript
2. Props 使用 interface 定义
3. 添加 JSDoc 注释
4. 使用 Tailwind CSS 样式
 
## 模板
 
```tsx
interface {{ComponentName}}Props {
  // ...
}
 
/**
 * {{ComponentName}} 组件
 */
export function {{ComponentName}}(props: {{ComponentName}}Props) {
  // ...
}

---
name: code-review
description: 执行标准化的代码审查
version: 1.0.0
tags:
  - review
  - quality
---
 
# 代码审查规范
 
## 检查项
 
### 安全性
- [ ] 没有 SQL 注入风险
- [ ] 用户输入经过校验（Zod / Joi / class-validator）
- [ ] 没有硬编码密钥或密码
- [ ] 敏感操作有权限校验
 
### 性能
- [ ] 没有 N+1 查询
- [ ] 大数据量有分页（limit/offset 或 cursor）
- [ ] 没有明显的内存泄漏
- [ ] 异步操作有适当的并发控制
 
### 可维护性
- [ ] 函数长度 < 50 行
- [ ] 命名清晰有意义（动词开头用于函数）
- [ ] 有适当的注释（复杂逻辑必须注释）
- [ ] 没有冗余代码
 
### 测试
- [ ] 新功能有单元测试
- [ ] 边界情况覆盖
- [ ] 异步代码有 await 测试
 
## 输出格式
 
对每个问题：
1. **严重程度**：🔴 严重 / 🟡 警告 / 🟢 建议
2. **位置**：文件名和行号
3. **问题**：描述
4. **建议**：如何修复
 
## 示例输出
 

{
  "rules": [
    "生成 React 组件时，使用项目定义的 react-component 技能",
    "提交代码前，使用 code-review 技能自我审查"
  ]
}

# 项目仓库
my-project/
├── src/
├── .opencode/
│   └── skills/
│       ├── code-review/
│       └── api-docs/
└── opencode.json

# 团队技能仓库
team-opencode-skills/
├── README.md
├── code-review/
│   └── SKILL.md
├── react-components/
│   └── SKILL.md
└── scripts/
    └── install.sh

#!/bin/bash
# scripts/install.sh
 
SKILLS_DIR="${HOME}/.config/opencode/skills"
REPO_URL="[email protected]:your-org/team-opencode-skills.git"
 
# 克隆或更新
if [ -d "$SKILLS_DIR/.git" ]; then
  cd "$SKILLS_DIR" && git pull
else
  git clone "$REPO_URL" "$SKILLS_DIR"
fi
 
echo "✅ 团队技能已同步到 $SKILLS_DIR"

{
  "name": "@your-org/opencode-skills",
  "version": "1.0.0",
  "scripts": {
    "postinstall": "node scripts/install.js"
  }
}

npm install -g @your-org/opencode-skills

---
name: skill-name
description: 清晰的技能描述
version: 1.0.0
license: MIT
author: your-name
tags:
  - relevant-tag
---
 
# 技能标题
 
## 简介
 
一两句话说明这个技能是做什么的。
 
## 使用场景
 
- 场景 1：...
- 场景 2：...
 
## 使用方式
 

---
name: api-design
description: 设计符合 RESTful 规范的 API
tags:
  - api
  - backend
---
 
# API 设计规范
 
## 路由命名
 
- 使用 kebab-case：`/user-profiles` 而非 `/userProfiles`
- 资源名用复数：`/orders` 而非 `/order`
- 动作用语义 HTTP 方法，不用动词路径
 
## 请求/响应格式
 
```json
// 请求
{
  "data": { ... }
}
 
// 成功响应
{
  "success": true,
  "data": { ... },
  "meta": { "page": 1, "perPage": 20 }
}
 
// 错误响应
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "字段 email 格式不正确",
    "details": [{ "field": "email", "issue": "invalid_format" }]
  }
}