前言

近期在搭建 Go 网约车项目的 AI 辅助开发工作流，过程中一步步厘清了 CodeBuddy 体系里 MCP、Skill、OpenSpec、Superpowers 这几个容易混淆的概念，也踩了安装操作的坑，在此整理完整认知与实操方案，方便后续复用以及同行参考。

一、各个名词逐层拆解释义

1. CodeBuddy：整体承载底座

它是嵌入 VS Code 的 AI 编程插件，充当整个体系的宿主容器，提供对话交互窗口、SkillHub 技能商店、MCP 管理面板两大安装入口，所有后续的技能、底层通信能力，全部依托它运行。

2. Skill：最小功能颗粒

Skill 即技能，是 CodeBuddy 生态中最小的可调度功能模块，每一项独立的自动化能力就是单独一个 Skill；功能相近的多个 Skill 打包之后就形成技能套件。 日常依靠斜杠指令来调用不同套件下面的技能：

• OpenSpec 系列技能调用前缀：/opsx:
• Superpowers 系列技能调用前缀：/skill:

3. OpenSpec：偏向规划归档的 Skill 套件

定位

偏向架构、产品侧的工作，主打规范驱动开发，负责前期敲定开发标准、后期沉淀开发档案，并不侧重精细写代码。

内置常用子技能

1. /opsx:explore：梳理模糊业务需求，调研第三方接口的潜在坑点；
2. /opsx:propose：输出正式需求规约、接口定义、项目目录规划；
3. /opsx:apply-change：依据已定的规范增量改动项目代码；
4. /opsx:archive-change：归档每次迭代的改动，将资料持久化存放到本地openspec/目录。

安装方式

通过npx @fission-ai/openspec init命令行初始化注入，不需要进入 SkillHub 手动操作。

4. Superpowers：偏向编码落地的 Skill 套件

定位

偏向日常后端开发实操，聚焦代码落地、质量把控，承接 OpenSpec 输出的设计方案完成编码工作。

内置常用子技能

1. /skill:brainstorm：细化需求实现细节；
2. /skill:tdd：遵循测试驱动开发模式，同步编写业务代码和单元测试；
3. /skill:debug-code：排查线上、开发阶段的代码报错；
4. /skill:refactor：重构旧代码，优化代码结构；
5. /skill:code-review：静态审查代码，排查代码规范与潜在漏洞。

安装踩坑记录

最开始尝试命令行执行npx @fission-ai/openspec install-plugin superpowers，抛出unknown command 'install-plugin'报错。排查确认 OpenSpec CLI 并不存在该子命令，Superpowers 只能在 CodeBuddy 侧边栏的 SkillHub 技能商店可视化安装，安装完成后重启 VS Code 才可生效。

5. MCP（Model Context Protocol，模型上下文协议）

通俗定位

整个体系底层的传动轴、标准化数据传输总线，本身不会进行需求设计、代码编写这类创造性工作，专门负责中转数据。

三大核心作用

1. 本地文件双向传输：帮助 AI 读取本地项目源码、OpenSpec 产出的规范文档，同时将 AI 生成的代码写入本地文件夹，免去手动复制粘贴代码的步骤；
2. 跨套件互通数据：自动把 OpenSpec 生成的设计规范传输给 Superpowers，实现两套技能流水线衔接；
3. 外部资源网关：统一管控 Git 操作、第三方 API 请求、数据库访问等外部操作，自带权限沙箱把控安全性。

二、清晰层级架构

plaintext

CodeBuddy（VS Code内AI宿主容器）
└── MCP（底层通信传动轴，统一完成所有数据搬运、外部工具调度）
    └── Skill（最小功能单元）
        ├ OpenSpec套件：把控需求规范、迭代变更、文档归档
        └── Superpowers套件：负责代码编写、测试、调试、重构评审

三、适配 Go 后端项目的标准实操流水线

以我正在开发的高德地图地理编码 SDK 封装需求作为实操示例：

1. 需求规划阶段：调用/opsx:propose Go封装高德Web服务客户端，实现地址与经纬度互转，适配中文URL转义、各类接口异常场景，OpenSpec 产出完整设计规约，经由 MCP 持久化保存到本地 openspec 目录；
2. 代码实现阶段：下发指令/skill:tdd 根据openspec目录中的规约文档完成业务代码与单元测试编写，MCP 自动传递规范数据，Superpowers 完成编码工作，代码经由 MCP 落地写入项目；
3. 收尾沉淀阶段：调用/opsx:archive-change归档本次迭代的全部改动，后续迭代、项目交接都可以回溯完整开发链路。

四、日常开发避坑清单

1. 安装区分两套套件渠道：OpenSpec 走命令初始化，Superpowers 务必在 SkillHub 安装，不要再使用无效的install-plugin指令；
2. 并发控制：不要同时触发两套技能针对同一个源码文件进行改动，防止代码互相覆盖错乱；
3. MCP 无需额外自建桥接插件：原生就可以完成 OpenSpec 与 Superpowers 的数据互通，省去手动搭建传动轴的工作量；
4. 环境生效细节：每次完成 Skill 或者 MCP 相关配置改动，重启 VS Code 保障配置正常加载；
5. 业务场景选择：小型工具模块可以单独使用 OpenSpec 快速生成方案；分销体系、风控系统这类复杂度偏高的模块，完整启用两套技能的流水线模式，提升代码规范性。

五、学习小结

一开始容易把 Skill、MCP 这两个概念混淆，误以为 skill 属于违禁关键词，后续理清层级才明白 skill 是功能模块的统称，MCP 是底层传输协议。二者搭配 OpenSpec、Superpowers 各司其职，能够搭建一套适配 Go 微服务项目的 AI 开发流水线，在后续网约车后端、多级分销、人脸核验相关的开发任务中都可以复用这套流程，减少重复工作、沉淀规范的开发文档。