Skills: 技能共享与市场
最后更新：2026-08-31
一个人的最佳实践是经验，一群人的最佳实践是标准——共享让 Skills 从个人工具变成团队资产。
1. 共享方式
(1) Git 仓库共享
最基础的共享方式，通过 Git 管理版本：
TEXT
📖 仅展示
团队 Skills 仓库结构
├── skills/
│ ├── code-review.md
│ ├── auto-test.md
│ ├── deploy.md
│ └── security-scan.md
├── README.md（索引和使用说明）
└── CHANGELOG.md（版本变更记录）
(2) 项目内嵌
将 Skills 直接放在项目目录中：
| 平台 | 目录 | 作用范围 |
|---|---|---|
| Claude Code | .claude/skills/ |
当前项目 |
| Cursor | .cursor/rules/ |
当前项目 |
| OpenCode | skills/ |
当前项目 |
(3) 全局安装
对所有项目生效：
BASH
# Claude Code 全局 Skills
~/.claude/skills/
# 用户级配置
~/.config/opencode/skills/
2. 发布流程
(1) Skill 质量检查清单
发布前必须检查：
TEXT
📖 仅展示
发布前检查
├── [ ] 提示词完整且具体
├── [ ] Frontmatter 信息准确（name、description、triggers）
├── [ ] 包含使用示例
├── [ ] 在至少 2 个项目上测试通过
├── [ ] 不包含项目敏感信息
├── [ ] 依赖的工具已说明
└── [ ] 包含 README 说明
(2) Skill 包结构
TEXT
📖 仅展示
发布包结构
├── skill-name.md # Skill 主文件
├── README.md # 使用说明
├── examples/ # 使用示例
│ └── example-1.md
└── CHANGELOG.md # 变更记录
(3) 版本号规范
TEXT
📖 仅展示
语义化版本：MAJOR.MINOR.PATCH
MAJOR：不兼容的提示词变更（输出格式变化）
MINOR：向后兼容的功能新增（新增审查维度）
PATCH：向后兼容的问题修复（修复提示词歧义）
示例：
1.0.0 → 首个正式版
1.1.0 → 新增安全审查维度
1.1.1 → 修复审查输出格式问题
2.0.0 → 重构输出格式（不兼容旧版）
3. 发现与安装
(1) 发现渠道
| 渠道 | 特点 | 适合 |
|---|---|---|
| GitHub 仓库 | 版本管理，可追溯 | 团队内部共享 |
| 社区论坛 | 讨论+反馈 | 通用 Skill |
| 官方市场 | 质量审核 | 高质量 Skill |
| 同事推荐 | 信任度高 | 行业特定 Skill |
(2) 安装流程
BASH
# 方式一：直接复制
cp community/code-review.md .claude/skills/
# 方式二：Git submodule
git submodule add https://github.com/team/skills.git .claude/skills-external
# 方式三：符号链接（开发时使用）
ln -s ~/shared-skills/code-review.md .claude/skills/code-review.md
(3) 依赖管理
YAML
# Skill 依赖声明
dependencies:
tools:
- Read
- Bash
skills:
- name: base-review
version: ">=1.0.0"
mcp_servers:
- database
4. 团队技能库实战
▶ 示例：构建团队 Skills 库
Alice 为团队建立了标准化的技能库：
TEXT
📖 仅展示
团队技能库
├── 01-执行类/ # 直接执行任务的 Skill
│ ├── deploy.md
│ ├── test-runner.md
│ └── lint-fix.md
├── 02-审查类/ # 分析和评估的 Skill
│ ├── code-review.md
│ ├── security-scan.md
│ └── performance-check.md
├── 03-辅助类/ # 提供建议的 Skill
│ ├── doc-generator.md
│ └── refactor-advisor.md
└── README.md # 索引和使用指南
Bob 说："Skills 库不是把文件放在一起——它需要分类、索引、版本管理，否则和乱堆文件没区别。"
❓ 常见问题
Q 社区 Skill 可以直接信任吗？
A 不可以。安装前必须审查提示词内容，确认不包含恶意指令（如读取密钥文件、执行危险命令）。
Q 如何处理团队 Skill 和个人 Skill 的冲突？
A 团队 Skill 优先级高于个人 Skill。个人自定义放在全局目录，团队标准放在项目目录。
Q Skill 更新后旧项目不兼容怎么办？
A 使用语义化版本。主版本号变更表示不兼容，旧项目锁定大版本号。
📖 小节
- 三种共享：Git 仓库、项目内嵌、全局安装
- 发布流程：质量检查 → 打包 → 版本号 → 发布
- 发现安装：GitHub、社区、市场 + 依赖管理
- 团队技能库：分类管理、索引维护、版本锁定
📝 作业
- 基础题（难度⭐）：将你创建的 Skill 整理到一个 Git 仓库，编写 README 索引。
- 进阶题（难度⭐⭐）：为团队创建分类技能库，包含执行类、审查类、辅助类各至少 1 个 Skill。
- 挑战题（难度⭐⭐⭐）：设计一个 Skill 依赖管理系统，支持版本声明、兼容性检查和自动更新提示。
