2.9 KiB
Executable File
2.9 KiB
Executable File
Skills
定义
Skills是可复用的AI能力单元,通过打包提示词、脚本、模版,进一步精确拓展AI的能力。
核心思想:将常用的能力封装成可复用的单元,提高AI的工作效率。
核心特征
1. 可复用
- 可以在多个项目中使用
- 可以在团队间共享
- 可以版本化管理
2. 触发词驱动
- 通过触发词调用
- 自动识别使用场景
- 无需手动配置
3. 封装完整
- 包含提示词
- 包含脚本工具
- 包含文档模版
组成
1. SKILL.md
- 技能描述
- 使用说明
- 触发词定义
2. 脚本文件
- 可执行的脚本
- 自动化工具
- 配置文件
3. 文档模版
- 输出格式模版
- 配置文件模版
- 报告模版
示例
Commit & Push Skill
# Commit & Push Skill
## 触发词
commit, push, 提交
## 执行
git add -A
git commit -m "{message}"
git push
## 规则
- 提交前检查lint
- 信息遵循conventional commit
- 推送前确认分支
Deploy Skill
# Deploy Skill
## 触发词
deploy, 部署, 发布
## 执行
npm run build
npx vercel --prod
## 规则
- 构建前运行测试
- 部署前确认环境
- 部署后验证功能
Test Skill
# 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
开发流程
- 需求分析:确定技能的功能和触发词
- 脚本开发:编写可执行的脚本
- 触发词定义:定义触发词和使用场景
- 测试验证:测试技能的功能
- 文档编写:编写SKILL.md文档
适用场景
- 常用操作:提交代码、部署、测试等
- 复杂流程:需要多个步骤的操作
- 团队协作:需要统一的操作规范
- 知识沉淀:最佳实践需要沉淀
优势
- 可复用:可以在多个项目中使用
- 易共享:可以在团队间共享
- 易维护:可以版本化管理
- 易扩展:可以快速添加新技能
挑战
- 初始成本:需要开发Skills
- 维护成本:需要持续维护Skills
- 学习成本:团队需要学习Skills
最佳实践
- 从常用操作开始:先封装最常用的操作
- 保持简单:每个Skill只做一件事
- 文档清晰:SKILL.md要清晰易懂
- 定期Review:定期审查和优化Skills
相关概念
- Harness工程:Skills是Harness的组成部分
- Agent_as_Code:Skills是Agent as Code的组成部分
- MCP:MCP和Skills都是AI的能力扩展方式