CodeBuddy 与 WorkBuddy 产品对比及 Skill / MCP 迁移指南

本文基于实际目录比对与配置核查整理，沉淀 CodeBuddy（JetBrains/PyCharm 插件）与 WorkBuddy（独立 AI 助手）在产品形态、Skill 与 MCP 存储/配置上的异同，并给出从 CodeBuddy 向 WorkBuddy 迁移 Skills 与 MCP 的可复用流程。

---

一、产品定位对比

维度	CodeBuddy	WorkBuddy
产品形态	JetBrains / PyCharm 等 IDE 插件（编辑器内嵌）	独立 AI 助手应用（Standalone）
所属生态	腾讯系 AI 编程助手	腾讯系 AI 助手平台
核心能力	代码补全、对话、Skills、MCP、插件市场	Skills、Connectors、Experts、本地文件/命令、浏览器等多能力
扩展机制	skills/ + mcp.json + plugins/marketplaces/（插件市场）	skills/ + mcp.json（Connectors）+ Experts
配置主目录	~/.codebuddy	~/.workbuddy
能力激活	IDE 内启停	连接器需在 UI 中点 Trust 才连接

⚠️ 说明：产品定位部分基于对本地配置结构的观察与公开认知；具体功能范围以官方文档为准。两者同属腾讯系，因此底层 Skill 与 MCP 约定高度一致，这是下文“可互通”的根本原因。

---

二、Skill 存储与配置

2.1 存储结构对比

维度	CodeBuddy（源）	WorkBuddy（目标）
用户级目录	~/.codebuddy/skills/<name>/	~/.workbuddy/skills/<name>/
入口文件	SKILL.md	SKILL.md
Frontmatter	name: + description:	name: + description:
附属资源	references/、scripts/、assets/	同左（标准 Skill 结构）
加载方式	IDE 自动扫描	WorkBuddy 自动扫描 ~/.workbuddy/skills/

2.2 存储路径示意（Mermaid）

flowchart LR subgraph CB["CodeBuddy ~/.codebuddy"] CB_S["skills//SKILL.md"] CB_R["skills//references"] CB_SC["skills//scripts"] CB_A["skills//assets"] end subgraph WB["WorkBuddy ~/.workbuddy"] WB_S["skills//SKILL.md"] WB_R["skills//references"] WB_SC["skills//scripts"] WB_A["skills//assets"] end CB_S -->|格式一致 可直接复制| WB_S CB_R --> WB_R CB_SC --> WB_SC CB_A --> WB_A

结论：Skill 目录同名、同结构，frontmatter 字段完全相同，直接复制整个 Skill 文件夹即可完成迁移，WorkBuddy 会自动加载。

---

三、MCP 存储与配置

3.1 配置对比

维度	CodeBuddy	WorkBuddy
配置文件	~/.codebuddy/mcp.json	~/.workbuddy/mcp.json
顶层键	mcpServers	mcpServers
服务器格式	stdio：type / command / args / env	同左
激活方式	IDE 内启用	需连接器管理页 Trust 才连接
合并策略	—	合并时保留 WorkBuddy 原有条目，不整体覆盖

3.2 配置结构示意（Mermaid）

flowchart TD subgraph File["mcp.json"] KEY["mcpServers"] S1["serverA: {type, command, args, env}"] S2["serverB: {type, command, args, env}"] KEY --- S1 KEY --- S2 end File -->|格式相同 合并 mcpServers| WB["~/.workbuddy/mcp.json"] WB -->|不会自动启用| TRUST["需连接器页点 Trust"] TRUST -->|连接成功| READY["MCP 可用"]

结论：两边 mcp.json 的 schema 完全一致，将 mcpServers 内容合并进 WorkBuddy 的 mcp.json 即可。唯一额外步骤：写入后必须到连接器管理页对该服务器点 Trust，否则不会真正连接。

---

四、为什么可以互通（兼容性根因）

CodeBuddy 与 WorkBuddy 同为腾讯系产品，Skill 与 MCP 的存储约定一致：

• Skill：均使用 SKILL.md 作为入口，frontmatter 仅依赖 name 与 description，且采用相同的 references/scripts/assets 资源目录约定。
• MCP：均使用 mcp.json 的 mcpServers 顶层键，stdio 服务器字段（type/command/args/env）完全一致。

因此迁移是“复制 + 合并”，而非“转换”。

mindmap root((CodeBuddy⇄WorkBuddy)) 产品对比 IDE插件 vs 独立应用 同属腾讯系 能力机制 Skills MCP Plugins/Connectors Experts Skill存储 目录同名 SKILL.md格式一致 资源目录一致 MCP配置 mcp.json mcpServers stdio格式一致 迁移流程 复制skill文件夹 合并mcp.json 手动Trust 验证触发 注意事项 成对迁移 Plugins≠Connectors 外部程序依赖

---

五、从 CodeBuddy 迁移到 WorkBuddy 的流程

5.1 流程图（Mermaid）

flowchart TD A[开始迁移] --> B[兼容性确认
目录与格式核对] B --> C{选择导入范围} C -->|Skills| D[复制 ~/.codebuddy/skills/<name>
→ ~/.workbuddy/skills/<name>] C -->|MCP| E[合并 mcpServers
→ ~/.workbuddy/mcp.json] D --> F[MCP 需在连接器页点 Trust] E --> F F --> G[验证：用触发词实测 Skill
与依赖该 MCP 的能力] G --> H{是否正常} H -->|是| I[完成] H -->|否| J[排查：Trust / App 是否安装
/ CodeBuddy 专有内部行为] J --> G

5.2 实操步骤

1. 兼容性确认（无需改文件）：核对两边 Skill 目录与 mcp.json 格式（见第二、三节）。
2. 导入 Skills：将 ~/.codebuddy/skills/<name> 整个文件夹复制到 ~/.workbuddy/skills/。
3. 合并 MCP：把 ~/.codebuddy/mcp.json 中的 mcpServers 合并进 ~/.workbuddy/mcp.json，保留 WorkBuddy 原有条目。
4. 激活 MCP（必须手动）：连接器管理页 → 自定义连接器 → 找到新增服务器 → 点 Trust。
5. 验证：在 WorkBuddy 中说出 Skill 的触发词，确认被加载；用依赖该 MCP 的能力实测一次。

5.3 配套脚本

已固化可复用 Skill codebuddy-to-workbuddy，其自带幂等脚本 scripts/import_codebuddy.py（仅复制/合并，绝不删除）：

# 导入全部 Skills 与 MCP
python3 ~/.workbuddy/skills/codebuddy-to-workbuddy/scripts/import_codebuddy.py

# 只导 Skills / 只导 MCP
python3 ~/.workbuddy/skills/codebuddy-to-workbuddy/scripts/import_codebuddy.py --skills-only
python3 ~/.workbuddy/skills/codebuddy-to-workbuddy/scripts/import_codebuddy.py --mcp-only

# 覆盖已存在的同名 Skill（MCP 已存在则始终跳过）
python3 ~/.workbuddy/skills/codebuddy-to-workbuddy/scripts/import_codebuddy.py --force

# 先看会做什么，不写文件
python3 ~/.workbuddy/skills/codebuddy-to-workbuddy/scripts/import_codebuddy.py --dry-run

---

六、关键注意事项

1. Skill 与 MCP 要成对迁移：若某 Skill 依赖某个 MCP（如 pencil-prototype 依赖 pencil-desktop），只导 Skill 不导 MCP 则该技能不可用。
2. Plugins ≠ Skills / Connectors：CodeBuddy 的 plugins/marketplaces/（如 codebuddy-plugins-official、cb_teams_marketplace）是一套“插件市场”机制，对应 WorkBuddy 的 Connectors / Experts，没有 1:1 文件夹映射，不能照搬，需各自走安装流程。
3. CodeBuddy 专有内部行为：个别 Skill 可能引用 CodeBuddy 独占的工具名或内部约定，导入后需实测触发词确认无报错。
4. MCP 路径有效性：CodeBuddy 的 MCP command 常指向具体 App（如 /Applications/Pen.app/...），目标机需已安装该 App，否则 Trust 后连接失败。