VibeSkills 多平台支持清单：7 大宿主适配器覆盖 Claude Code、Codex、Cursor 等主流 AI 编程应用-开发者社区

VibeSkills 多平台支持清单：7 大宿主适配器覆盖 Claude Code、Codex、Cursor 等主流 AI 编程应用

【免费下载链接】Vibe-SkillsIntelligent Skill routing and workflow orchestration for AI agents — +21.12 pp reward, −29.6% tokens on SkillsBench with DeepSeekV4Flash-VE.项目地址: https://gitcode.com/gh_mirrors/vi/Vibe-Skills

VibeSkills 是一个为 AI 编程 Agent 提供智能技能路由与工作流编排的工具集，它把规划、执行、审查等本地 Skills 资源统一调度起来。而让这套能力"开箱即用"的关键，正是仓库 adapters/ 目录下的多平台宿主适配器：一套安装包，就能接入 Codex、Claude Code、Cursor、Windsurf、OpenCode、OpenClaw 等主流 AI 应用，甚至支持其他具备 Skills 能力的宿主。

7 大宿主适配器总览

所有适配器都连接同一个宿主中立的 VibeSkills 核心，不区分"优劣"，只描述各自的接入形态与诚实的降级状态。完整清单见 adapters/index.json，设计规则见 adapters/README.md。

宿主	状态	接入模式	宿主设置面
Codex	supported-with-constraints	governed（受治理，最强通道）	`~/.agents/settings.json`+`AGENTS.md`
Claude Code	supported-with-constraints	preview-guidance（有界托管设置面）	`~/.claude/settings.json`+`CLAUDE.md`
Cursor	preview	preview-guidance（宿主托管边界）	`~/.cursor/settings.json`
Windsurf	preview	runtime-core（宿主根目录载荷落地）	`~/.codeium/windsurf`
OpenClaw	preview	runtime-core（宿主根目录载荷落地）	`~/.openclaw`
OpenCode	preview	preview-guidance（命令/Agent/示例配置脚手架）	`~/.config/opencode/opencode.json.example`
Generic（通用）	advisory-only	契约消费者，面向其他 Skills 宿主	宿主自定义的中立目录

每个适配器目录都包含四份"合同"文件：

host-profile.json：宿主能力、设置面与降级契约（如 claude-code、cursor）
settings-map.json：设置项映射
closure.json：宿主闭环声明
platform-linux.json/platform-macos.json/platform-windows.json：三平台支持契约

适配器设计的 3 条铁律

在 adapters/README.md 中，多平台适配被明确约束，避免"过度承诺"：

适配器不取代官方运行时——官方 runtime 仍是唯一的规范执行主体；
适配器不拥有路由真相——所有宿主共享同一路由与入口契约 config/vibe-entry-surfaces.json；
适配器只描述能力、设置映射与诚实的降级状态——可以是supported、preview或not-yet-proven，但绝不过度声称未验证的闭环。

逐个看：每个宿主是怎么接入的

🔹 Codex：受治理的旗舰通道

Codex 是当前默认适配器（default_adapter_id: "codex"），也是唯一governed全链路（安装、体检、引导均受治理）的宿主。适配器会把运行时载荷写入共享 agents 根，并在AGENTS.md中以**托管块（managed block）**方式注入引导规则——只合并、从不覆盖你的文件，触发词统一为$vibe//vibe。细节见 adapters/codex/host-profile.json。

🔹 Claude Code：有界托管设置面

Claude Code 走bridged_runtime桥接模式：安装时保留你原有的~/.claude/settings.json，仅追加一段 VibeSkills 托管区块；全局指令同样以托管块写入CLAUDE.md。插件启用、MCP 注册、凭据等仍归宿主自管，边界清晰，详见 adapters/claude-code/host-profile.json。

🔹 Cursor：预览期，边界诚实

Cursor 处于preview状态：仓库会在~/.cursor/下落地命令、宿主闭环清单与最小设置面，但不声称完整闭环——更广泛的宿主原生工作流行为仍属预览范围。配置见 adapters/cursor/host-profile.json。

🔹 Windsurf / OpenClaw：runtime-core 直投

两者都是preview状态的runtime-core适配器：直接把宿主中立的运行时载荷物化到各自文档化的宿主根目录（~/.codeium/windsurf、~/.openclaw），而登录态、模型权限、BYOK 边界等仍由宿主管理。分别见 adapters/windsurf/host-profile.json 与 adapters/openclaw/host-profile.json。

🔹 OpenCode：命令 + Agent 脚手架

OpenCode 适配器会安装 skills、命令、Agent 与宿主闭环元数据，并提供opencode.json.example配置脚手架——真正的opencode.json保持宿主自管，不自动改写。示例配置在 config/opencode/opencode.json.example。

🔹 Generic：其他 AI 应用的兜底路径

如果你的 AI 应用支持 Skills 目录扫描但没有专属适配器，generic适配器作为契约消费者提供中立安装路径：它只落地 runtime-core 载荷，能力项标注为host-defined，不做任何宿主闭环声明。见 adapters/generic/host-profile.json。

统一安装模型：一条命令通吃 7 个宿主

多平台支持最大的好处是零分叉的安装体验：无论哪个宿主，安装接口永远是install --skills-dir <SkillsDir>，安装后的目录结构永远是<SkillsDir>/vibe。不同宿主改变的只是SkillsDir路径与调用语法，不会出现第二份安装包或运行时。

# Linux / macOS（install.sh 会自检 Python 3.10+） bash ./install.sh --skills-dir "$HOME/.agents/skills" bash ./check.sh --skills-dir "$HOME/.agents/skills"

# Windows（官方运行时在 Windows 上是 full-authoritative 级别） pwsh -NoProfile -File .\install.ps1 -SkillsDir "$HOME\.agents\skills" pwsh -NoProfile -File .\check.ps1 -SkillsDir "$HOME\.agents\skills"

默认目录~/.agents/skills；用 Claude Code 或 Codex 时可直接换成~/.claude/skills、~/.codex/skills
安装收据位于<SkillsDir>/vibe/.vibeskills/install-receipt.json
更新用update.sh/update.ps1，卸载只需删除<SkillsDir>/vibe文件夹
完整说明见 docs/install/README.md

操作系统支持：Windows、Linux、macOS 三轴矩阵

平台支持按宿主 × 平台双轴独立记账，绝不把推断路径标成已验证。当前基线（见 config/platform-support-policy.json）：

Windows：官方运行时full-authoritative
Linux：supported-with-constraints（无 PowerShell 时降级为degraded-but-supported，doctor 与一致性门可跳过）
macOS：not-yet-proven（尚未冻结契约，不做完整闭环声明）

Codex、Claude Code、Cursor 等适配器各自附带platform-linux.json、platform-macos.json、platform-windows.json三平台契约，升级状态必须通过推广门（promotion gate）才能提升。