CodeBuddy 的 Skill（技能）是可复用的能力包，直接在技能市场安装即可一键使用，也能自建 Skill 扩展能力。

一、Skill 快速使用（安装+调用）

1. 安装 Skill（3 种方式）

1. 技能市场安装（推荐）

• 打开 CodeBuddy → 左侧「技能市场」
• 搜索目标 Skill（如csv to excel）→「添加」一键安装

2. 本地导入 Skill

• 把 Skill 文件夹（含SKILL.md）拖入 CodeBuddy 窗口
• 或通过菜单「技能 → 导入技能」选择文件夹

3. 项目/用户目录放置

• 项目级：.codebuddy/skills/[技能名]/SKILL.md
• 用户级：~/.codebuddy/skills/[技能名]/SKILL.md

2. 调用 Skill（自动/手动）

• 自动触发：直接发需求，AI 会匹配已安装 Skill
  例：把下面 CSV 转成 Excel+ 粘贴 CSV 内容

• 手动指定（识别不准时）
  输入：使用 [技能名] 完成：xxx
  例：使用 csv to excel 技能转换：...

二、自建 Skill（基础结构+示例）

1. Skill 目录结构

my-skill/ ├── SKILL.md # 核心配置（必需） ├── scripts/ # 可执行脚本（可选，Python/Bash） ├── references/ # 参考文档（可选） └── assets/ # 模板/资源（可选）

2. SKILL.md 格式（必写）

--- name: csv-to-excel description: 把 CSV 文本或文件转换为 Excel 文件 allowed-tools: Read, Write, Bash --- 你是 CSV 转 Excel 专家，按以下步骤处理： 1. 接收用户的 CSV 文本或文件路径 2. 用 pandas 生成 .xlsx 文件 3. 返回文件路径并确认转换成功

3. 生效与测试

• 保存到.codebuddy/skills/→ 重启 CodeBuddy
• 对话输入：使用 csv-to-excel 技能转换...测试

三、常用技巧与注意事项

• 查看已安装技能：左侧「技能」面板，可启用/禁用
• 技能共享：开发好的 Skill 可打包上传到 SkillHub
• 权限控制：allowed-tools限制技能可用工具（如 Bash/Write）
• 不生效排查：
  1. SKILL.md的 YAML 格式是否正确
  2. 目录是否放在正确的skills文件夹
  3. 技能名是否与调用指令一致

四、示例：用「代码审查」Skill

1. 安装：技能市场搜索code-review→ 添加
2. 使用：

使用 code-review 技能审查下面 Python 代码： [粘贴代码]

3. 效果：AI 按规范输出审查报告（风格/性能/安全）

举例 打包发布skill

根据官方文档，Skill 放在.codebuddy/skills/目录下就会自动生效，AI 根据description自动触发。

当前结构：

F:\phpstudy\WWW\27.comdianshangerp\.codebuddy\skills\ ├── php-deploy-backup/ ← Skill 目录（已创建） │ ├── SKILL.md │ ├── scripts/ │ │ ├── deploy.sh │ │ ├── backup.sh │ │ └── rollback.sh │ └── references/ │ └── deploy_guide.md └── php-deploy-backup.zip ← 打包文件

使用方法：

1. 自动触发— 当你在对话中提到类似需求时，AI 会自动识别并加载：

   • “部署到服务器”
   • “打包修改的文件”
   • “备份后再覆盖”
   • “tar 打包 PHP 文件”
   • “服务器回滚”

2. 手动调用— 直接说：

   使用 php-deploy-backup skill 帮我打包这些文件

   或

   @php-deploy-backup 部署到服务器