156 lines
2.9 KiB
Markdown
Executable File
156 lines
2.9 KiB
Markdown
Executable File
# 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的能力扩展方式
|