BaoYu Skills 使用完全指南
BaoYu Skills 是一个专为 AI Agent 设计的技能库,包含了大量实用的任务模板和最佳实践。本指南将详细介绍如何安装、使用和创建自己的技能。
项目地址: https://github.com/JimLiu/baoyu-skills
什么是 BaoYu Skills?
BaoYu Skills 是一个开源的技能库,为 AI Agent(如 OpenClaw、Claude Code、Hermes)提供可复用的任务模板。
核心优势
- 📦 开箱即用 - 100+ 预定义技能,覆盖开发、运维、数据分析等领域
- 🎯 最佳实践 - 每个技能都经过实战验证
- 🔧 易于扩展 - Markdown 格式,简单易懂
- 🌟 社区驱动 - 持续更新,欢迎贡献
技能分类
BaoYu Skills 包含以下分类:
-
软件开发 (software-development)
- Next.js 开发和部署
- Spring Boot 开发
- 数据库迁移
- API 集成调试
- 系统化调试方法
-
DevOps (devops)
- Docker 部署
- CI/CD 流程
- 系统监控
- 服务恢复
-
数据科学 (data-science)
- Jupyter 笔记本交互
- 数据清洗
- 可视化
-
AI/ML (mlops)
- 模型训练
- 模型部署
- 评估和优化
-
自动化 (autonomous-ai-agents)
- 多 Agent 协作
- 任务调度
- 进度监控
快速开始
1. 安装 BaoYu Skills
方法一:Git Clone(推荐)
# 克隆仓库到本地
git clone https://github.com/JimLiu/baoyu-skills.git
# 进入目录
cd baoyu-skills
# 查看所有技能
ls -la skills/
方法二:下载 ZIP
访问 GitHub Release 下载最新版本。
2. 配置技能路径
OpenClaw
将技能库路径添加到配置中:
# ~/.openclaw/config.yaml
skills:
paths:
- ~/.openclaw/skills # 默认技能目录
- ~/baoyu-skills/skills # BaoYu Skills 目录
或者,直接复制技能到默认目录:
cp -r baoyu-skills/skills/* ~/.openclaw/skills/
Hermes Agent
# ~/.hermes/config.yaml
skills:
paths:
- ~/.hermes/skills
- ~/baoyu-skills/skills
3. 验证安装
# 列出所有技能(OpenClaw)
openclaw skills list
# 列出所有技能(Hermes)
hermes skills list
# 查看特定技能
openclaw skills view nextjs-vercel-website-deployment
核心技能使用指南
1. Next.js Vercel 网站部署
技能名称: nextjs-vercel-website-deployment
用途: 完整的 Next.js 项目创建和 Vercel 部署流程
使用方法:
You: 使用 nextjs-vercel-website-deployment 技能创建一个个人博客
Assistant: [加载技能]
好的,我将按照以下步骤创建并部署网站:
1. 创建 Next.js 项目
- 初始化 Next.js 15 + TypeScript
- 安装 Tailwind CSS
2. 开发核心页面
- 首页(/)
- 博客列表(/blog)
- 文章详情(/blog/[id])
- 关于页面(/about)
3. GitHub 配置
- 初始化 Git 仓库
- 创建 GitHub 远程仓库
- 推送代码
4. Vercel 部署
- 安装 Vercel CLI
- 关联项目
- 部署到生产环境
涉及的步骤:
- ✅ 项目初始化
- ✅ 依赖安装
- ✅ 代码开发
- ✅ Git 版本控制
- ✅ GitHub 推送
- ✅ Vercel 部署
- ✅ 环境变量配置
2. 系统化调试(Systematic Debugging)
技能名称: systematic-debugging
用途: 遇到任何 Bug、测试失败或异常时的系统化调试方法
使用方法:
You: 我的 API 返回 500 错误,帮我调试
Assistant: [加载 systematic-debugging 技能]
开始系统化调试:
第 1 步:复现问题
- 当前环境:开发环境
- 触发条件:访问 /api/posts
- 错误信息:Internal Server Error (500)
第 2 步:收集日志
[调用 terminal] 查看服务器日志
发现错误:TypeError: Cannot read property 'id' of undefined
第 3 步:定位根因
[调用 read_file] 读取 API 代码
发现问题:缺少 null 检查
第 4 步:修复问题
[调用 patch] 添加 null 检查
if (!user) {
return res.status(401).json({ error: 'Unauthorized' });
}
第 5 步:验证修复
[调用 terminal] 重启服务
[调用 terminal] 测试 API
✅ 问题已解决!
调试流程:
- 复现问题 - 确认问题存在
- 收集信息 - 日志、错误栈、环境
- 分析根因 - 代码审查、数据检查
- 制定方案 - 修复策略
- 实施修复 - 代码变更
- 验证修复 - 测试确认
- 文档记录 - 记录问题和解决方案
3. Spring Boot + MyBatis-Plus 兼容性
技能名称: spring-boot-mybatis-plus-compatibility
用途: 解决 Spring Boot 和 MyBatis-Plus 版本兼容性问题
典型场景:
You: Spring Boot 3.2 无法启动,报 MyBatis-Plus 错误
Assistant: [加载技能]
诊断步骤:
1. 检查版本兼容性
- Spring Boot: 3.2.x
- MyBatis-Plus: 3.5.3.1
- ✅ 版本匹配
2. 检查依赖冲突
[调用 terminal] mvn dependency:tree
发现冲突:mybatis-spring-boot-starter
3. 修复方案
[调用 patch] 更新 pom.xml
排除冲突依赖,统一版本
4. 重新构建
[调用 terminal] mvn clean install
✅ 构建成功!
4. Next.js + Giscus 评论集成
技能名称: nextjs-giscus-comments
用途: 在 Next.js 项目中集成 Giscus 评论系统
使用方法:
You: 为我的博客添加 Giscus 评论系统
Assistant: [加载技能]
集成步骤:
1. 安装依赖
[调用 terminal] npm install @giscus/react
2. 创建评论组件
[调用 write_file] app/components/Comments.tsx
集成 Giscus React 组件
3. 配置参数
- repo: your-username/your-repo
- repo-id: R_xxx
- category: General
- category-id: DIC_xxx
4. 在文章页面引入
[调用 patch] app/blog/[id]/page.tsx
添加 <Comments /> 组件
5. 测试评论功能
[调用 terminal] npm run dev
访问文章页面,验证评论加载
✅ 评论系统集成完成!
5. 前后端 API 集成调试
技能名称: frontend-backend-api-integration-fix
用途: 系统化诊断和修复前后端 API 集成问题
典型问题:
- 前端显示"无数据"
- API 调用失败
- 数据格式不匹配
- 跨域错误
调试流程:
You: 前端页面显示"无数据",但后端有数据
Assistant: [加载技能]
系统化诊断:
第 1 层:前端验证
1. 检查 API 调用
[调用 read_file] src/api/posts.js
发现:URL 正确,请求方法正确
2. 检查控制台错误
[调用 vision_analyze] 浏览器截图
发现:返回数据是空数组
第 2 层:网络层验证
3. 检查网络请求
[调用 terminal] curl http://localhost:8080/api/posts
返回:200 OK,数据正常
第 3 层:后端验证
4. 检查控制器代码
[调用 read_file] PostController.java
发现:返回格式是 Result<List<Post>>
5. 诊断问题
前端期望:{ data: [...] }
后端返回:{ code: 200, data: [...], msg: "success" }
问题:前端 Axios 拦截器双层包装导致 data 为空
第 4 层:修复问题
6. 修复拦截器
[调用 patch] src/utils/request.js
response.data.data -> response.data
7. 验证修复
[调用 terminal] npm run dev
✅ 数据正常显示!
进阶技能
6. Next.js + NextAuth.js E2E 测试
技能名称: nextjs-nextauth-e2e-testing
用途: 端到端测试 Next.js + NextAuth.js 应用
测试场景:
- 登录流程
- 认证状态
- 权限控制
- 会话管理
7. PostgreSQL 触发器调试
技能名称: postgresql-trigger-function-debugging
用途: 调试 PostgreSQL 触发器函数错误
常见错误:
- ERROR 42883: function does not exist
- 参数类型不匹配
- 触发器逻辑错误
8. 项目目录清理
技能名称: project-directory-cleanup
用途: 系统化清理混乱的项目目录结构
清理步骤:
- 分析现有结构
- 设计新结构
- 迁移文件
- 更新引用路径
- 验证功能
9. 子 Agent 驱动开发
技能名称: subagent-driven-development
用途: 使用多个独立 Agent 并行开发功能
适用场景:
- 大型功能开发
- 独立模块开发
- 并行任务处理
10. 测试驱动开发(TDD)
技能名称: test-driven-development
用途: 在实现功能前先编写测试
TDD 流程:
- Red - 编写失败的测试
- Green - 编写最小代码使测试通过
- Refactor - 重构代码
- 重复
创建自定义技能
技能文件结构
---
name: my-custom-skill
description: 简短描述技能用途
triggers:
- 关键词1
- 关键词2
category: software-development
---
# 技能名称
## 概述
简要说明技能的用途和适用场景。
## 何时使用
- 场景 1
- 场景 2
- 场景 3
## 前置条件
- 要求 1
- 要求 2
## 操作步骤
### Step 1: 第一步标题
详细说明...
\`\`\`bash
# 示例命令
npm install xxx
\`\`\`
### Step 2: 第二步标题
详细说明...
## 常见陷阱
- ❌ 错误做法 1
- 为什么错
- 正确做法
## 验证方法
1. 验证步骤 1
2. 验证步骤 2
## 参考资料
- [文档链接](https://example.com)
技能最佳实践
-
清晰的触发条件
- 定义明确的关键词
- 描述适用场景
-
详细的步骤说明
- 编号的步骤
- 实际的命令示例
- 预期的输出
-
完整的错误处理
- 常见错误
- 解决方案
- 验证方法
-
丰富的示例
- 代码片段
- 配置文件
- 命令输出
提交技能到 BaoYu Skills
- Fork 仓库
- 创建技能文件
- 测试技能
- 提交 Pull Request
# Fork 并克隆
git clone https://github.com/YOUR_USERNAME/baoyu-skills.git
cd baoyu-skills
# 创建分支
git checkout -b add-my-skill
# 添加技能文件
cat > skills/my-category/my-skill.md << 'EOF'
---
name: my-skill
description: My awesome skill
category: my-category
---
...
EOF
# 提交
git add skills/my-category/my-skill.md
git commit -m "feat: add my-skill for doing something"
git push origin add-my-skill
# 在 GitHub 上创建 Pull Request
实战案例
案例 1:部署个人博客
需求: 创建并部署一个 Next.js 个人博客到 Vercel
使用的技能:
nextjs-vercel-website-deployment- 项目创建和部署nextjs-neon-postgres-integration- 数据库集成nextjs-giscus-comments- 评论系统
执行流程:
You: 帮我创建一个完整的个人博客,包含数据库和评论功能
Assistant: [依次加载 3 个技能]
1. 创建 Next.js 项目并部署
✅ 项目创建完成
✅ 推送到 GitHub
✅ 部署到 Vercel
2. 集成 Neon Postgres 数据库
✅ 创建数据库
✅ 设计表结构
✅ 迁移数据
3. 添加 Giscus 评论系统
✅ 安装依赖
✅ 配置组件
✅ 测试评论
🎉 博客已完成!访问: https://your-blog.vercel.app
案例 2:修复生产环境 Bug
问题: 生产环境 API 返回 500 错误
使用的技能:
systematic-debugging- 系统化调试frontend-backend-api-integration-fix- API 集成调试
调试流程:
You: 生产环境 API 突然 500 错误,帮我紧急修复
Assistant: [加载 systematic-debugging]
紧急响应流程:
第 1 步:快速止损
[调用 terminal] kubectl rollback deployment api
✅ 回滚到上一个稳定版本
第 2 步:复现问题
[调用 terminal] 查看生产日志
发现:数据库连接超时
第 3 步:诊断根因
[调用 terminal] 检查数据库状态
发现:连接池耗尽(max 10, active 15)
第 4 步:临时修复
[调用 patch] 增加连接池大小到 50
[调用 terminal] 重新部署
第 5 步:验证修复
[调用 terminal] curl 测试 API
✅ 200 OK
第 6 步:长期优化
- 添加连接池监控
- 优化慢查询
- 设置告警
✅ 问题已解决,系统恢复正常!
案例 3:项目重构
需求: 清理混乱的项目目录结构
使用的技能:
project-directory-cleanup- 目录清理systematic-debugging- 验证功能
重构流程:
You: 我的项目目录很混乱,帮我重新组织
Assistant: [加载 project-directory-cleanup]
重构计划:
第 1 步:分析现状
当前结构:
- 文件散乱
- 命名不规范
- 缺少分类
第 2 步:设计新结构
/src
/components # React 组件
/pages # 页面
/utils # 工具函数
/api # API 客户端
/types # TypeScript 类型
第 3 步:迁移文件
[调用 terminal] 批量移动文件
✅ 100 个文件已迁移
第 4 步:更新导入路径
[调用 search_files] 查找所有 import
[调用 patch] 批量更新路径
第 5 步:验证功能
[调用 terminal] npm run test
✅ 所有测试通过
🎉 项目重构完成!
技能目录
按分类浏览
软件开发 (40+ 技能)
- nextjs-vercel-website-deployment
- nextjs-giscus-comments
- nextjs-neon-postgres-integration
- spring-boot-mybatis-plus-compatibility
- systematic-debugging
- test-driven-development
- ... 更多
DevOps (15+ 技能)
- hermes-agent-hang-recovery
- pm-agent-hang-prevention
- system-monitor-script-debugging
- webhook-subscriptions
- ... 更多
AI/ML (20+ 技能)
- dspy
- trl-fine-tuning
- grpo-rl-training
- pytorch-fsdp
- ... 更多
数据科学 (10+ 技能)
- jupyter-live-kernel
- ... 更多
自动化 (15+ 技能)
- hermes-multi-agent-team
- subagent-driven-development
- ... 更多
按用途浏览
快速开发
- nextjs-vercel-website-deployment
- wordpress-to-nextjs-vercel-migration
- nextjs-supabase-admin-setup
问题调试
- systematic-debugging
- frontend-backend-api-integration-fix
- spring-security-login-401-debugging
- mybatis-plus-field-mapping-debugging
性能优化
- nextjs-supabase-query-optimization
- nextjs-server-component-hot-reload
项目管理
- writing-plans
- requesting-code-review
- project-directory-cleanup
常见问题
Q1: 技能加载失败?
检查清单:
# 1. 检查路径配置
cat ~/.openclaw/config.yaml | grep skills
# 2. 验证技能文件存在
ls ~/baoyu-skills/skills/
# 3. 检查文件格式
openclaw skills validate my-skill
# 4. 查看错误日志
openclaw --debug
Q2: 如何更新技能库?
cd ~/baoyu-skills
git pull origin main
Q3: 技能执行不符合预期?
- 阅读技能文档中的"常见陷阱"章节
- 检查前置条件是否满足
- 按照步骤逐一验证
- 提交 Issue 反馈问题
Q4: 如何贡献新技能?
参考"创建自定义技能"章节,然后:
- Fork 仓库
- 创建技能文件
- 测试技能
- 提交 Pull Request
进阶资源
- 📚 GitHub 仓库: https://github.com/JimLiu/baoyu-skills
- 💬 讨论区: https://github.com/JimLiu/baoyu-skills/discussions
- 🐛 问题反馈: https://github.com/JimLiu/baoyu-skills/issues
- 📖 贡献指南: https://github.com/JimLiu/baoyu-skills/blob/main/CONTRIBUTING.md
总结
BaoYu Skills 是一个强大的技能库,能够显著提升 AI Agent 的开发效率。通过:
- ✅ 使用现有技能 - 开箱即用,快速解决问题
- ✅ 创建自定义技能 - 沉淀经验,构建知识库
- ✅ 贡献社区 - 分享技能,帮助他人
你可以打造一个高效的 AI 开发工作流。
立即开始: git clone https://github.com/JimLiu/baoyu-skills.git
最后更新: 2026-05-11