Skills: 安装与环境配置
最后更新：2026-08-31
工欲善其事，必先利其器。5 分钟搭建 Skills 开发环境，让 AI 助手学会新技能。
1. 环境要求
| 项目 | 最低要求 | 推荐版本 |
|---|---|---|
| AI 编码助手 | Claude Code / OpenCode | 最新版 |
| Node.js | 18+ | 20+ |
| Git | 2.30+ | 最新版 |
| 操作系统 | Windows / macOS / Linux | 任意 |
| 编辑器 | VS Code / Cursor | 最新版 |
验证环境：
BASH
node --version # v20.11.0
git --version # git version 2.43.0
claude --version # Claude Code v1.0+ (如使用)
2. 各平台 Skills 目录
(1) Claude Code
BASH
# 项目级 Skills（推荐，跟随项目版本管理）
mkdir -p .claude/skills
# 用户级 Skills（所有项目共享）
mkdir -p ~/.claude/skills
(2) OpenCode
BASH
# 项目级 Skills
mkdir -p skills
# 用户级 Skills
mkdir -p ~/.config/opencode/skills
(3) Cursor Rules
BASH
# 项目级规则
mkdir -p .cursor/rules
3. 目录结构规范
一个规范的 Skills 项目结构：
TEXT
📖 仅展示
project/
├── .claude/
│ ├── skills/ # Claude Code 技能目录
│ │ ├── code-review.md # 代码审查技能
│ │ ├── deploy.md # 部署技能
│ │ └── test-gen.md # 测试生成技能
│ └── settings.json # Claude Code 配置
├── skills/ # OpenCode 技能目录
│ ├── code-review.md
│ └── deploy.md
├── .cursor/
│ └── rules/ # Cursor 规则目录
│ └── review.mdc
└── .gitignore
(1) 单文件 Skill 格式
每个 Skill 是一个 Markdown 文件：
MARKDOWN
---
name: code-review
description: "代码审查技能，自动检测安全问题和性能瓶颈"
triggers:
- keyword: "review|审查"
- file_pattern: "**/*.{py,ts,js}"
tools:
- Read
- Grep
- Glob
---
# Code Review Skill
当用户请求代码审查时，按以下流程执行：
1. 读取目标文件
2. 检查安全问题
3. 检查性能瓶颈
4. 生成审查报告
(2) 多文件 Skill 格式
复杂 Skill 可以拆分为多个文件：
TEXT
📖 仅展示
.claude/skills/code-review/
├── SKILL.md # 主技能文件
├── prompts/ # 提示词模板
│ ├── security.md
│ └── performance.md
├── examples/ # 示例
│ └── sample-review.md
└── config.yaml # 额外配置
4. 配置 Skills 激活
(1) 自动加载
Skills 放在对应目录后自动可用，无需额外配置。
(2) 手动引用
在某些平台中，可以显式引用 Skill：
JSON
// .claude/settings.json
{
"skills": [
"code-review",
"deploy",
"test-gen"
]
}
(3) 条件激活
YAML
# 只在特定分支激活
triggers:
- condition: "git_branch == 'main'"
- condition: "file_changed matches '**/api/**'"
5. 验证环境
创建一个测试 Skill 验证环境配置成功：
MARKDOWN
---
name: hello-skill
description: "测试技能，验证环境配置"
triggers:
- keyword: "hello-skill"
---
# Hello Skill
当用户说 "hello-skill" 时，回复：
"Skills 环境配置成功！当前项目：{project_name}，可用工具：Read、Write、Bash"
Alice 按照以上步骤创建目录和测试 Skill 后，输入 "hello-skill" 立即看到响应。Bob 说："5 分钟就能跑起来，比配置 CI/CD 简单多了。"
❓ 常见问题
Q 项目级和用户级 Skills 有什么区别？
A 项目级 Skills 放在项目
.claude/skills/ 目录，跟随项目 Git 管理，团队共享；用户级 Skills 放在 ~/.claude/skills/，所有项目可用但不进版本管理。Q 不同平台的 Skill 能互用吗？
A 核心提示词部分通用，但触发器和工具绑定的语法各平台不同。建议以 Markdown 为主，平台特定配置用条件注释隔离。
Q Skill 文件名有什么规范？
A 推荐 kebab-case 命名（如
code-review.md），名称与 name 字段保持一致，方便管理。📖 小节
- 各平台 Skills 目录位置不同，但核心结构一致
- 单文件 Skill 用 Markdown + YAML frontmatter 定义
- 项目级 Skills 跟随 Git 版本管理，用户级全局可用
- 用 hello-skill 测试环境配置是否成功
📝 作业
- 基础题（难度⭐）：在你使用的 AI 编码助手中创建 Skills 目录，并创建 hello-skill 测试。
- 进阶题（难度⭐⭐）：为你的项目设计一个 Skills 目录结构，至少包含 3 个技能文件的规划。
- 挑战题（难度⭐⭐⭐）：写一个脚本，自动检测当前项目使用的 AI 平台，创建对应的 Skills 目录和示例文件。
