Update from Sync Service
This commit is contained in:
155
AI工程/概念/Skills.md
Executable file
155
AI工程/概念/Skills.md
Executable file
@@ -0,0 +1,155 @@
|
||||
# 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的能力扩展方式
|
||||
Reference in New Issue
Block a user