# Skills

> 相关：[[Harness工程]]、[[Agent_as_Code]]、[[MCP]]

## 定义

**Skills**是可复用的AI能力单元，通过打包提示词、脚本、模版，进一步精确拓展AI的能力。

**核心思想**：将常用的能力封装成可复用的单元，提高AI的工作效率。

## 核心特征

### 1. 可复用
- 可以在多个项目中使用
- 可以在团队间共享
- 可以版本化管理

### 2. 触发词驱动
- 通过触发词调用
- 自动识别使用场景
- 无需手动配置

### 3. 封装完整
- 包含提示词
- 包含脚本工具
- 包含文档模版

## 组成

### 1. SKILL.md
- 技能描述
- 使用说明
- 触发词定义

### 2. 脚本文件
- 可执行的脚本
- 自动化工具
- 配置文件

### 3. 文档模版
- 输出格式模版
- 配置文件模版
- 报告模版

## 示例

### Commit & Push Skill
```markdown
# Commit & Push Skill

## 触发词
commit, push, 提交

## 执行
git add -A
git commit -m "{message}"
git push

## 规则
- 提交前检查lint
- 信息遵循conventional commit
- 推送前确认分支
```

### Deploy Skill
```markdown
# Deploy Skill

## 触发词
deploy, 部署, 发布

## 执行
npm run build
npx vercel --prod

## 规则
- 构建前运行测试
- 部署前确认环境
- 部署后验证功能
```

### Test Skill
```markdown
# Test Skill

## 触发词
test, 测试, 运行测试

## 执行
mvn test

## 规则
- 运行所有测试
- 生成测试报告
- 失败时提供修复建议
```

## 目录结构

```
skills/
├── commit-push/
│   ├── SKILL.md
│   └── commit.sh
├── deploy/
│   ├── SKILL.md
│   └── deploy.sh
├── test/
│   ├── SKILL.md
│   └── test.sh
└── code-review/
    ├── SKILL.md
    └── review.sh
```

## 开发流程

1. **需求分析**：确定技能的功能和触发词
2. **脚本开发**：编写可执行的脚本
3. **触发词定义**：定义触发词和使用场景
4. **测试验证**：测试技能的功能
5. **文档编写**：编写SKILL.md文档

## 适用场景

- **常用操作**：提交代码、部署、测试等
- **复杂流程**：需要多个步骤的操作
- **团队协作**：需要统一的操作规范
- **知识沉淀**：最佳实践需要沉淀

## 优势

- **可复用**：可以在多个项目中使用
- **易共享**：可以在团队间共享
- **易维护**：可以版本化管理
- **易扩展**：可以快速添加新技能

## 挑战

- **初始成本**：需要开发Skills
- **维护成本**：需要持续维护Skills
- **学习成本**：团队需要学习Skills

## 最佳实践

1. **从常用操作开始**：先封装最常用的操作
2. **保持简单**：每个Skill只做一件事
3. **文档清晰**：SKILL.md要清晰易懂
4. **定期Review**：定期审查和优化Skills

## 相关概念

- [[Harness工程]]：Skills是Harness的组成部分
- [[Agent_as_Code]]：Skills是Agent as Code的组成部分
- [[MCP]]：MCP和Skills都是AI的能力扩展方式