CodeBuddy Skills 全面指南概念、可用技能、使用方式与开发场景实战一、什么是 Skills技能系统Skills 是 CodeBuddy 的扩展能力系统本质是一组模块化、自包含的能力包——通过封装「专门知识 工作流 工具调用」把通用的 AI Agent 变成某一领域的专家。官方对它的定位类比成针对特定领域的入职指南当任务匹配时Skill 的内容会被注入到 AI 上下文中引导 AI 按专业流程执行而不是泛泛而谈。一个 Skill 能提供的四类能力能力说明专业工作流针对特定领域的自动多步骤程序如先审查→再重构→最后补测试工具集成处理特定文件格式PDF/Excel或调用特定 API 的指令领域专业知识公司特定的架构、业务逻辑、编码规范打包资源复杂/重复任务所需的脚本、参考文档、模板资产与 MCP 的区别容易混淆MCP 解决连接外部工具/数据源如百度地图、MySQL、Playwright 浏览器Skills 解决把完成任务的方法论固化下来。两者常配合使用——例如一个e2e-testSkill 内部调用 Playwright 这个 MCP。注博客https://blog.csdn.net/badao_liumang_qizhi二、Skills 的来源与加载优先级CodeBuddy 的 Skills 来自三个层级优先级从高到低项目级Project Skills.codebuddy/skills/项目根目录优先级最高跟随仓库走适合团队规范。用户级User Skills~/.codebuddy/skills/用户主目录对所有项目生效。插件提供Plugin Skills通过插件市场加载在/skills面板中单独归类显示。内置打包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 转可搜索 PDFdocx创建/编辑 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。