1. 为什么我们需要AI Skill
作为一名长期与AI编程助手打交道的开发者,我深刻理解那种重复解释相同规则的痛苦。每次开始新项目,我都要不厌其烦地告诉AI:"记得用TypeScript而不是JavaScript"、"组件命名要用PascalCase"、"API调用前必须做错误处理"...这种重复劳动不仅浪费时间,更糟糕的是容易遗漏重要细节。
OpenCode Skill的出现彻底改变了这种状况。它本质上是一种标准化的AI指令封装机制,允许开发者将那些需要反复强调的编程规范、项目约定和工作流程打包成可复用的"技能包"。当AI遇到相关场景时,会自动加载这些预设指令,无需开发者每次都重复说明。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Skill的核心结构与工作原理
2.1 Skill的目录结构解析
一个标准的Skill通常包含以下文件和目录:
code复制my-skill/
├── SKILL.md # 核心指令文件(必须)
├── scripts/ # 可执行脚本(可选)
│ ├── pre-process.py
│ └── post-process.sh
├── references/ # 参考文档(可选)
│ └── style-guide.pdf
└── assets/ # 资源文件(可选)
└── template.md
其中SKILL.md是每个Skill必须包含的核心文件,它采用YAML frontmatter+Markdown的混合格式。这种设计既保证了机器可读性,又保持了人类可编辑性。
2.2 SKILL.md的编写规范
一个典型的SKILL.md文件示例如下:
markdown复制---
name: react-component
description: 创建符合团队规范的React组件
version: 1.2.0
tags:
- react
- frontend
---
## 使用场景
当需要创建新的React组件时自动应用此技能
## 核心规范
1. 必须使用TypeScript
2. 组件命名采用PascalCase
3. 必须包含PropTypes定义
4. 样式使用CSS Modules
5. 必须包含单元测试骨架
## 示例模板
``
