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 部署到服务器