OpenCode必备Skill库：21个专业技能一站式指南

让 AI 秒变专家的秘籍

为什么需要技能库？

想象一下：你的 AI 助手突然精通 Python 开发、UML 绘图、单元测试、API 设计...

这不是梦——OpenCode Skills 让这一切成为现实。

技能（Skills）是预置的专家知识包，AI 加载后瞬间掌握专业领域能力。

🚀 快速上手

两种方式使用技能

方式 1：使用 / 命令（推荐）

在 OpenCode 中直接输入：

/python-development
/testing-unit
/technical-writing
/uml-diagrams

方式 2：使用 skill_find/skill_use

# 1. 搜索技能
skill_find "python"

# 2. 加载技能
skill_use "python-development"

# 3. 直接使用
# "用 Python 创建一个用户验证模块"

📦 完整技能清单（21个）

🐍 Python 开发

| 技能 | 功能 |
|------|------|
| python-development | PEP 8 规范、类型提示、异步编程、类设计 |
| testing-unit | 单元测试、TDD、Mock、pytest 最佳实践 |

📐 系统设计

| 技能 | 功能 |
|------|------|
| uml-diagrams | 类图、时序图，活动图、状态图、部署图 |
| system-design | 可扩展架构、分布式系统、CAP 定理 |
| api-design | RESTful API、URL 设计、版本控制、认证 |
| database-schema | 表设计、索引优化、范式化、迁移策略 |
| code-review | 代码审查清单，安全检查，性能分析 |

📝 文档写作

| 技能 | 功能 |
|------|------|
| technical-writing | API 文档、用户指南、教程、发布说明 |
| uml-diagrams | UML 图表、架构图、流程图 |

📊 办公文档

| 技能 | 功能 |
|------|------|
| xlsx | 财务模型、透视表、公式、图表 |
| pptx | 商业演示、融资 PPT，培训材料 |
| word-documents | 技术文档、提案、报告 |
| pdf-documents | 可填写表单、PDF/A 归档、安全设置 |
| ppt-slides | 幻灯片设计、动画、模板 |
| document-templates | 文档模板，品牌规范 |

🌐 开发工具

| 技能 | 功能 |
|------|------|
| mcp-builder | MCP 服务器、工具开发、API 集成 |
| web-testing | 功能测试、自动化测试，性能测试 |
| algorithmic-art | p5.js 生成艺术、参数化设计 |

🎨 企业应用

| 技能 | 功能 |
|------|------|
| brand-guidelines | 品牌规范，文案、视觉一致性 |
| create-article | 文章创作、内容策略、SEO 优化 |
| skill-creator | 自定义技能开发 |

💡 实用场景

场景 1：开发新功能

/python-development
/api-design
/database-schema

# 直接命令
"创建一个用户管理 API，包含注册、登录、权限验证"

场景 2：写技术文档

/technical-writing
/uml-diagrams

# "为订单系统写 API 文档，并绘制类图和流程图"

场景 3：创建演示文稿

/pptx
/brand-guidelines

# "创建一个产品发布 PPT，使用公司品牌规范"

场景 4：测试驱动开发

/testing-unit
/python-development

# "用 TDD 方式开发一个计算器模块，先写测试"

🛠️ 管理技能

查看已安装技能

skill_find "*"

复制到项目

# 项目级技能目录
cp -r ~/.config/opencode/skills/my-skill .opencode/skills/

自定义技能

# 创建新技能
mkdir -p .opencode/skills/my-custom-skill
# 添加 SKILL.md 配置文件
# 重启 OpenCode 加载

📈 推荐组合

全栈开发

• python-development
• api-design
• database-schema
• testing-unit

技术写作

• technical-writing
• uml-diagrams
• document-templates

DevOps

• mcp-builder
• web-testing
• docker-devops (待添加)

商业演示

• pptx
• brand-guidelines
• excel-spreadsheets

🔧 配置文件

opencode.json

{
  "plugins": ["@zenobius/opencode-skillful"],
  "$schema": "https://opencode.ai/config.json"
}

.opencode-skillful.json

{
  "promptRenderer": "xml",
  "modelRenderers": {
    "opencode/minimax-m2.1-free": "xml"
  }
}

📚 技能存放位置

| 类型 | 路径 |
|------|------|
| 全局技能 | ~/.config/opencode/skills/ |
| 项目技能 | .opencode/skills/ |
| 技能库备份 | ~/learn/new_v2/md/anthropic_skills/ |

⚡ 技能命令速查表

常用命令

| 操作 | 命令 |
|------|------|
| 搜索技能 | skill_find "关键词" |
| 列出所有 | skill_find "*" |
| 加载技能 | skill_use "技能名" |
| 加载多个 | skill_use "A", "B" |
| 读取资源 | skill_resource skill_name="技能名" relative_path="路径" |
| 使用 / 命令 | /技能名 |

常用 / 命令

| /命令 | 功能 |
|-------|------|
| /python-development | Python 开发 |
| /testing-unit | 单元测试 |
| /technical-writing | 技术写作 |
| /uml-diagrams | UML 图表 |
| /api-design | API 设计 |
| /pptx | PPT 演示 |
| /excel-spreadsheets | Excel 数据 |
| /code-review | 代码审查 |
| /mcp-builder | MCP 开发 |
| /brand-guidelines | 品牌规范 |

🎯 下一步

1. 重启 OpenCode 加载新技能
2. 方式一：直接输入 /python-development
3. 方式二：使用 skill_find "python" 搜索后加载
4. 开始使用："创建一个用户验证模块"

提示: 技能库持续更新中，关注获取更多专业技能！