CodeBuddy Skills 全面指南：概念、可用技能、使用方式与开发场景实战

CodeBuddy Skills 全面指南：概念、可用技能、使用方式与开发场景实战

---

一、什么是 Skills（技能系统）

Skills 是 CodeBuddy 的扩展能力系统 ，本质是一组模块化、自包含的能力包------通过封装「专门知识 + 工作流 + 工具调用」，把通用的 AI Agent 变成某一领域的"专家"。

官方对它的定位，类比成"针对特定领域的入职指南"：当任务匹配时，Skill 的内容会被注入到 AI 上下文中，引导 AI 按专业流程执行，而不是泛泛而谈。

一个 Skill 能提供的四类能力：

能力	说明
专业工作流	针对特定领域的自动多步骤程序（如"先审查→再重构→最后补测试"）
工具集成	处理特定文件格式（PDF/Excel）或调用特定 API 的指令
领域专业知识	公司特定的架构、业务逻辑、编码规范
打包资源	复杂/重复任务所需的脚本、参考文档、模板资产

与 MCP 的区别 （容易混淆）：MCP 解决"连接外部工具/数据源 "（如百度地图、MySQL、Playwright 浏览器）；Skills 解决"把完成任务的方法论固化下来 "。两者常配合使用------例如一个 e2e-test Skill 内部调用 Playwright 这个 MCP。

---

注：

博客：

https://blog.csdn.net/badao_liumang_qizhi

二、Skills 的来源与加载优先级

CodeBuddy 的 Skills 来自三个层级，优先级从高到低：

1. 项目级（Project Skills） ：.codebuddy/skills/（项目根目录），优先级最高，跟随仓库走，适合团队规范。
2. 用户级（User Skills） ：~/.codebuddy/skills/（用户主目录），对所有项目生效。
3. 插件提供（Plugin Skills） ：通过插件市场加载，在 /skills 面板中单独归类显示。
4. 内置打包（product-bundled）：官方内置，不受安全闸门约束、自动放行。

AI 会根据任务匹配度、工具需求、上下文相关性自动选择 合适的 Skill；也可手动用 /skill-name 触发。

---

三、可直接使用的 Skills 详解

3.1 开发 / 自动化类

agent-browser --- 浏览器自动化

• 用途：基于开源 agent-browser CLI，支持 macOS/Linux/Windows x64；打开网页、截图、抽取页面内容、点击元素、填表单、测试 Web 流程。
• 适用：Web 自动化测试、竞品页面信息采集。

playwright-cli --- Playwright 浏览器交互

• 用途：基于 Playwright 的浏览器交互自动化，E2E 测试、表单填充、截图、Web 流程验证。
• 示例调用（自然语言）："打开 http://localhost:3000，登录后截图首页，并检查控制台有无报错。"

find-skills --- 技能发现器

• 用途：当你问"怎么做 X / 有没有现成的 skill"时，帮你发现并安装合适的 agent skill。
• 适用：想扩展能力但不知道装哪个时用它搜。

skill-creator --- 创建自己的 Skill

• 用途：手把手教你怎么写 SKILL.md、怎么打包脚本与资源，把团队最佳实践固化成可复用技能。
• 适用：当你发现自己反复给 AI 写同一段指令时，就该用它造一个 Skill。

3.2 多模态 / 内容生成类

多模态内容生成 --- AI 创作媒体

• 用途：文生视频、图生视频、文生图、文生 3D 模型、图生 3D 模型、图片/视频特效。
• 适用：需要 AI 生成营销素材、演示动画、原型图时。

3.3 文档处理类（开发中也很常用）

Skill	用途
pdf	读取/合并/拆分/旋转/加水印/对扫描件 OCR 转可搜索 PDF
docx	创建/编辑 Word 文档（报告、备忘、合同、带目录页眉的正式文档）
xlsx	打开/清洗/计算/图表化电子表格，CSV/TSV 互转
pptx	创建/修改 PowerPoint（做汇报、培训材料）

示例："把 docs/需求.docx 里第三章的表格提取出来，重算汇总金额，生成新的 预算.xlsx。"

---

四、开发者高频场景与技能方向

官方和社区文档反复出现的高频开发场景，通常对应这些技能方向（多从插件市场或网络导入，非出厂自带）：

场景	典型技能方向	解决什么
代码审查	code-review / security-audit	命名规范、SQL 注入、漏洞、性能短板自动体检
重构优化	refactor	把坏味道代码按最佳实践重写
测试生成	test-writer / unit-test	按函数/模块自动补单元测试
性能压测	perf-test	官方概述点名的典型场景之一
安全审计	security-audit	官方概述点名的另一典型场景
数据分析	data-analysis / visualization	清洗、统计、matplotlib 出图
深度研究	deep-research	用子代理做 fork 式调研
Office 文档	pdf / docx / xlsx / pptx	处理需求文档、报表、合同

社区里有一批公认的生产级工程 Skills（如从 addyosmani/agent-skills 仓库引入的工程技能），覆盖上面多数场景；通过"导入 Skill"装上即可用。

---

五、完整使用指南

5.1 查看已装技能

在客户端执行 /skills 命令，会列出 User / Project / Plugin 三类技能及各自预估 token 占用。

5.2 导入技能（安装）

• 设置页右上角点**「导入 Skill」**，从网络/插件市场装入。
• 这相当于安装第三方或官方共享 Skill。

5.3 自己编写一个 Skill

在项目根建目录与文件：

.codebuddy/skills/<skill-name>/
├── SKILL.md          # 必需
├── scripts/         # 可选：可执行脚本（Python/Bash 等）
├── references/      # 可选：按需加载到上下文的参考文档
└── assets/          # 可选：模板、图标、字体等输出用资源

SKILL.md 结构（含必需元信息）：

---
name: pdf-editor
description: 当用户要求修改、旋转或从 PDF 文件中提取文本时使用。
allowed-tools: Read, Write, Bash(pdftotext:*)
disable: false
---

# PDF 编辑器

收到 PDF 修改请求时：
1. 先用 `pdftotext` 提取文本确认内容
2. 用 scripts/rotate.py 处理旋转
3. ...

渐进式披露设计原则（决定加载多少上下文）：

• 第 1 级：元数据 description（始终在上下文，约 100 词）
• 第 2 级：SKILL.md 主体（触发时加载，< 5k 词）
• 第 3 级：打包资源（按需由 AI 加载，无限制）

5.4 触发方式

• 自动 ：AI 根据对话意图匹配 description 自动加载。
• 手动 ：输入框用 /skill-name 触发（除非 SKILL.md 设了 disable-model-invocation: true 隐藏）。
• 权限控制 ：用 allowed-tools 白名单限制工具（如只允许 Bash(git:*)），技能在自身 baseDirectory 内运行。

---

六、实战示例

示例 1：用 playwright-cli 给前端做冒烟测试

"启动 ui-react 的 dev server，打开首页，截图，并报告是否有 JS 控制台报错。"

AI 自动加载 playwright-cli → 启动浏览器 → 访问页面 → 截图 → 抓控制台日志 → 汇总结果。

示例 2：用 skill-creator 固化团队规范

"我们团队要求所有 Java 接口都要有 Swagger 注解和统一返回体，帮我做一个 Skill，以后新写接口时自动按这个规范。"

AI 用 skill-creator 引导 → 在 .codebuddy/skills/java-api-convention/SKILL.md 写入规范与示例 → 以后你说"写个用户查询接口"就会自动带上注解。

示例 3：文档流水线（组合多个文档 Skill）

"读取 需求.pdf，把变更点整理成 变更说明.docx，并生成一页 汇报.pptx 给老板。"

依次调用 pdf（抽取）→ docx（写说明）→ pptx（出汇报）。

示例 4：用 find-skills 扩展能力

"我想给项目加自动生成单元测试的能力，有没有现成 skill？"

AI 调 find-skills → 检索匹配 → 提示安装 test-writer 类技能 → 安装后直接可用。

---

七、给开发者的推荐组合

如果你主要做 Java / 前端开发，最实用的组合是：

目的	推荐 Skill
前端 E2E + 公网截图验证	playwright-cli / agent-browser
固化构建/部署/编码规范	skill-creator（自己造 Skill）
处理需求/报表/合同	xlsx / docx / pdf
做汇报材料	pptx
扩展更多能力	find-skills（搜 code-review / refactor / test 类装上）

---

八、一句话总结

Skills 是 CodeBuddy 把"专家方法论 "打包成可复用能力包的机制：当前环境已自带浏览器自动化、文档处理（PDF/Word/Excel/PPT）、多模态生成、技能发现与创建等实用技能；开发者最常用的方向是代码审查、重构、测试生成、安全审计与性能压测；想扩展就用 /skills 查看、导入 Skill 安装，或 skill-creator 自己造一个跟随项目的团队规范 Skill。

---