首页/博客/AI 开发/BaoYu Skills 使用完全指南
AI 开发

BaoYu Skills 使用完全指南

👤程俊杰📅2026年5月11日⏱️15 分钟阅读
--

详细介绍 BaoYu Skills 技能库的安装、使用和扩展方法。掌握 100+ 实用技能,提升 AI Agent 开发效率。

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 包含以下分类:

  1. 软件开发 (software-development)

    • Next.js 开发和部署
    • Spring Boot 开发
    • 数据库迁移
    • API 集成调试
    • 系统化调试方法
  2. DevOps (devops)

    • Docker 部署
    • CI/CD 流程
    • 系统监控
    • 服务恢复
  3. 数据科学 (data-science)

    • Jupyter 笔记本交互
    • 数据清洗
    • 可视化
  4. AI/ML (mlops)

    • 模型训练
    • 模型部署
    • 评估和优化
  5. 自动化 (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
✅ 问题已解决!

调试流程:

  1. 复现问题 - 确认问题存在
  2. 收集信息 - 日志、错误栈、环境
  3. 分析根因 - 代码审查、数据检查
  4. 制定方案 - 修复策略
  5. 实施修复 - 代码变更
  6. 验证修复 - 测试确认
  7. 文档记录 - 记录问题和解决方案

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

用途: 系统化清理混乱的项目目录结构

清理步骤:

  1. 分析现有结构
  2. 设计新结构
  3. 迁移文件
  4. 更新引用路径
  5. 验证功能

9. 子 Agent 驱动开发

技能名称: subagent-driven-development

用途: 使用多个独立 Agent 并行开发功能

适用场景:

  • 大型功能开发
  • 独立模块开发
  • 并行任务处理

10. 测试驱动开发(TDD)

技能名称: test-driven-development

用途: 在实现功能前先编写测试

TDD 流程:

  1. Red - 编写失败的测试
  2. Green - 编写最小代码使测试通过
  3. Refactor - 重构代码
  4. 重复

创建自定义技能

技能文件结构

---
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)

技能最佳实践

  1. 清晰的触发条件

    • 定义明确的关键词
    • 描述适用场景
  2. 详细的步骤说明

    • 编号的步骤
    • 实际的命令示例
    • 预期的输出
  3. 完整的错误处理

    • 常见错误
    • 解决方案
    • 验证方法
  4. 丰富的示例

    • 代码片段
    • 配置文件
    • 命令输出

提交技能到 BaoYu Skills

  1. Fork 仓库
  2. 创建技能文件
  3. 测试技能
  4. 提交 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

使用的技能:

  1. nextjs-vercel-website-deployment - 项目创建和部署
  2. nextjs-neon-postgres-integration - 数据库集成
  3. 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 错误

使用的技能:

  1. systematic-debugging - 系统化调试
  2. 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:项目重构

需求: 清理混乱的项目目录结构

使用的技能:

  1. project-directory-cleanup - 目录清理
  2. 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: 技能执行不符合预期?

  1. 阅读技能文档中的"常见陷阱"章节
  2. 检查前置条件是否满足
  3. 按照步骤逐一验证
  4. 提交 Issue 反馈问题

Q4: 如何贡献新技能?

参考"创建自定义技能"章节,然后:

  1. Fork 仓库
  2. 创建技能文件
  3. 测试技能
  4. 提交 Pull Request

进阶资源

总结

BaoYu Skills 是一个强大的技能库,能够显著提升 AI Agent 的开发效率。通过:

  1. 使用现有技能 - 开箱即用,快速解决问题
  2. 创建自定义技能 - 沉淀经验,构建知识库
  3. 贡献社区 - 分享技能,帮助他人

你可以打造一个高效的 AI 开发工作流。

立即开始: git clone https://github.com/JimLiu/baoyu-skills.git


最后更新: 2026-05-11

分享文章

💬 评论区

💡 使用 GitHub 账号登录即可评论

📑目录