Claude Code 的 Skills 机制让开发者可以通过 Markdown 文件定义可复用的 AI 工作流,但大多数人仍停留在"一次性 prompt"的阶段——每次都重新编写指令,缺乏系统化的组织和复用方式。JimLiu 开发的 Baoyu Skills 项目正是为了解决这一痛点:它提供了一套精心设计的 Claude Code Skills 合集,通过独创的二维设计体系将 prompt engineering 从手工艺提升为工程实践。截至目前,该项目在 GitHub 上已收获超过 4.1K 星标。
什么是 Claude Code Skills?
在深入 Baoyu Skills 之前,有必要先理解 Claude Code 的 Skills 机制。Skills 本质上是存储在项目 .claude/skills/ 目录下的 Markdown 文件,当用户通过斜杠命令调用时,Claude Code 会将这些文件作为上下文注入到对话中,从而引导 AI 按照预定义的模式执行任务。
<!-- .claude/skills/example.md -->
# 技能名称
## 触发条件
当用户请求 XXX 时触发
## 执行步骤
1. 第一步操作
2. 第二步操作
3. 输出格式要求
Skills 的优势在于:它们是纯文本文件,可以用 Git 管理版本,可以在团队间共享,也可以像代码一样进行 code review。但问题在于,大多数开发者编写的 Skills 质量参差不齐,缺乏统一的设计方法论。
二维设计体系:Type x Style
Baoyu Skills 最核心的创新是其二维设计体系。项目作者将每个 Skill 的设计分解为两个维度:
- Type(类型维度):定义 Skill 要完成的任务类别,如封面图生成、幻灯片制作、代码审查等
- Style(风格维度):定义输出的表现风格,如简约、学术、商务、手绘等
这种正交分解意味着 M 种类型和 N 种风格可以组合出 M x N 种变体,而不需要为每种组合单独编写完整的 Skill。
# 二维设计示例
skills:
baoyu-cover-image:
type: cover-image-generation
styles:
- minimalist # 简约风格
- gradient # 渐变风格
- illustration # 插画风格
- photography # 摄影风格
baoyu-slide-deck:
type: slide-generation
styles:
- corporate # 商务风格
- academic # 学术风格
- creative # 创意风格
这种设计理念借鉴了软件工程中的"关注点分离"原则——类型决定"做什么",风格决定"怎么呈现",两者互不干扰又可以自由组合。

核心 Skills 详解
Baoyu Skills 目前包含多个精心设计的 Skill,覆盖了从内容创作到开发辅助的多个场景:
baoyu-cover-image:封面图生成
这是项目中最受欢迎的 Skill 之一。它能够根据文章标题和摘要自动生成视觉吸引力强的封面图描述或 SVG 图形。使用方式非常简单:
# 在 Claude Code 中调用
/baoyu-cover-image --title "深度学习入门指南" --style gradient
该 Skill 内部会根据标题语义分析选择合适的配色方案、布局和视觉元素,输出一段可以直接用于图片生成的详细描述或一份完整的 SVG 代码。
baoyu-slide-deck:幻灯片生成
将长文内容自动转化为结构化的幻灯片大纲,支持多种呈现风格。它不仅仅是简单的内容切割,而是会进行信息密度分析和视觉层次重组:
/baoyu-slide-deck --input article.md --style corporate --slides 15
生成的幻灯片大纲包含每页的标题、要点、配图建议和演讲者备注,可以直接导入到 Keynote 或 PowerPoint 中使用。
baoyu-code-review:代码审查
面向开发者的 Skill,能够按照预定义的审查清单对代码进行系统化审查,输出结构化的审查报告。它会检查代码质量、安全漏洞、性能瓶颈和可维护性等方面。
安装与使用
Baoyu Skills 的安装过程非常简单,只需要将 Skills 文件复制到项目的 .claude/skills/ 目录即可:
# 克隆仓库
git clone https://github.com/JimLiu/baoyu-skills.git
# 将需要的 Skills 复制到你的项目
cp -r baoyu-skills/skills/baoyu-cover-image .claude/skills/
cp -r baoyu-skills/skills/baoyu-slide-deck .claude/skills/
# 或者一次性安装所有 Skills
cp -r baoyu-skills/skills/* .claude/skills/
安装后,在 Claude Code 中通过斜杠命令即可调用。每个 Skill 都包含详细的使用说明和参数文档,首次使用时建议先阅读对应的 README 文件。
项目还提供了一个 install.sh 脚本用于自动化安装和更新:
# 自动安装并保持更新
bash <(curl -s https://raw.githubusercontent.com/JimLiu/baoyu-skills/main/install.sh)
从实践中提炼的 Prompt Engineering 方法论
Baoyu Skills 不仅仅是一组工具,更是一套经过实践验证的 prompt engineering 方法论。从 80aj.com 等社区分享的实践经验来看,以下几点设计原则值得借鉴:
结构化优于自由文本:每个 Skill 都有严格的输入输出格式定义,避免 AI 输出的不确定性。这对于需要稳定输出的生产环境尤为重要。
约束优于自由:通过明确的约束条件(如字数限制、格式要求、风格指南)来缩小 AI 的输出空间,从而提高输出质量的一致性。
可测试性:每个 Skill 都可以用相同的输入反复测试,便于评估和优化 prompt 的效果。这一点在传统的"聊天式"prompt 中几乎不可能实现。
版本控制:Skills 作为纯文本文件纳入 Git 管理,每次修改都有记录可追溯,团队协作时可以通过 PR 流程审查 prompt 变更。
# 查看 Skill 的修改历史
git log --oneline .claude/skills/baoyu-cover-image/
# 对比两个版本的差异
git diff v1.0..v2.0 .claude/skills/baoyu-cover-image/skill.md
与其他 Skills 生态的对比
Claude Code 的 Skills 生态正在快速发展,除了 Baoyu Skills 之外,社区中还涌现了 Hugging Face Skills、OpenSpec 等多个项目。Baoyu Skills 的独特价值在于:
- 二维设计体系:这是目前唯一采用正交分解设计的 Skills 合集,可扩展性远超单一维度的 Skills
- 中文优先:由中文开发者设计,对中文内容场景的支持比英文项目更好
- 实战导向:每个 Skill 都经过大量实际使用验证,而非概念验证
总结
Baoyu Skills 代表了 prompt engineering 从"手工艺"向"工程化"演进的一个重要方向。它的二维设计体系(Type x Style)为 Skills 的组织和复用提供了一种优雅的方法论,使得 AI 工作流可以像软件模块一样被设计、测试和维护。
对于正在使用 Claude Code 的开发者来说,Baoyu Skills 既可以作为即插即用的工具集直接使用,也可以作为设计自己 Skills 的参考范本。4.1K 星标的增长速度说明,开发者社区对这种工程化 prompt 管理方式有着强烈的需求。
评论