PLATFORM_GUIDE.md 6.7 KB
宿主兼容性说明（Host Compatibility）
full-stack-skills 以标准 Agent Skills（含 SKILL.md 的目录）形式发布技能，通过
npx skills add 安装到任何遵循该规范的宿主。
历史说明：本仓库早期版本包含一个独立的适配器 CLI（
fskill命令与adapters/目录）， 用于向非标准宿主导出专有包装物（Cursor rule、Trae plugin、Qoder agent、CodeBuddy workflow 等）。 该适配器已移除，仓库不再提供或维护任何适配器二进制。所有技能以标准SKILL.md目录为唯一事实源， 由各宿主自身的技能加载机制消费。
安装方式
一条命令安装任意技能包（无需本仓库提供任何适配层）：
# 安装整个技能包
npx skills add full-stack-skills/vue-skills
# 只安装包内的指定技能
npx skills add full-stack-skills/vue-skills --skill vue3
技能包仓库地址：https://github.com/full-stack-skills/<package>（如 full-stack-skills/vue-skills）。
宿主兼容性状态
本表按验证程度区分状态，供下游审计：
| 状态 | 含义 |
|---|---|
| 已验证 (verified) | 在真实宿主中安装并确认技能可被加载与触发 |
| 可安装 (installable) | 目录约定与标准 Agent Skills 一致，有社区安装使用记录；本项目未做系统性兼容测试 |
| 参考 (reference) | 路径来自公开兼容矩阵，本项目未测试 |
| 宿主 | 全局安装路径 | 状态 | 说明 |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ |
已验证 | 本项目主要开发与验证宿主；各包均提供 .claude-plugin/plugin.json |
| Codex | ~/.codex/skills/ |
可安装 | 使用标准 .agents/skills/ 项目路径约定 |
| CodeBuddy | ~/.codebuddy/skills/ |
可安装 | 使用标准技能目录约定；本项目未做系统性兼容测试，与其官方无认证关系 |
| WorkBuddy | ~/.workbuddy/skills/ |
可安装 | 已观测到实际安装使用（~/.workbuddy/skills/ 下存在本项目的技能目录）；本项目未做系统性兼容测试，与其官方无认证关系 |
| 其他宿主 | 见下方参考矩阵 | 参考 | 路径来自公开兼容矩阵，未逐一验证 |
关于 WorkBuddy / CodeBuddy：两者均不是本项目的官方背书宿主（endorsed host）， 本项目也未与其建立任何形式的认证或合作关系。技能可在上述宿主中通过标准技能目录安装使用， 但兼容性未经系统化测试；采用前请自行验证。
平台路径参考矩阵
以下矩阵描述各宿主的技能目录约定，用于人工安装或自行编写转换脚本时参考。
数据整理自公开的 Agent Skills 兼容矩阵（以 vercel-labs/skills 为基线），本项目未逐一验证。
| Platform | ID / Aliases | Project Path | Global Path |
|---|---|---|---|
| Amp | amp |
.agents/skills/ |
~/.config/agents/skills/ |
| Kimi Code CLI | kimi-cli |
.agents/skills/ |
~/.config/agents/skills/ |
| Replit | replit |
.agents/skills/ |
~/.config/agents/skills/ |
| Universal | universal |
.agents/skills/ |
~/.config/agents/skills/ |
| Antigravity | antigravity |
.agents/skills/ |
~/.gemini/antigravity/skills/ |
| Augment | augment |
.augment/skills/ |
~/.augment/skills/ |
| Claude Code | claude-code, claude |
.claude/skills/ |
~/.claude/skills/ |
| OpenClaw | openclaw |
skills/ |
~/.openclaw/skills/ |
| Cline | cline |
.agents/skills/ |
~/.config/agents/skills/ |
| Warp | warp |
.agents/skills/ |
~/.config/agents/skills/ |
| CodeBuddy | codebuddy |
.codebuddy/skills/ |
~/.codebuddy/skills/ |
| Codex | codex |
.agents/skills/ |
~/.codex/skills/ |
| Command Code | command-code |
.commandcode/skills/ |
~/.commandcode/skills/ |
| Continue | continue |
.continue/skills/ |
~/.continue/skills/ |
| Cortex Code | cortex |
.cortex/skills/ |
~/.snowflake/cortex/skills/ |
| Crush | crush |
.crush/skills/ |
~/.config/crush/skills/ |
| Cursor | cursor |
.agents/skills/ |
~/.cursor/skills/ |
| Deep Agents | deepagents, deep-agents |
.agents/skills/ |
~/.deepagents/agent/skills/ |
| Droid | droid |
.factory/skills/ |
~/.factory/skills/ |
| Gemini CLI | gemini-cli |
.agents/skills/ |
~/.gemini/skills/ |
| GitHub Copilot | github-copilot, copilot |
.agents/skills/ |
~/.copilot/skills/ |
| Goose | goose |
.goose/skills/ |
~/.config/goose/skills/ |
| Junie | junie |
.junie/skills/ |
~/.junie/skills/ |
| iFlow CLI | iflow-cli |
.iflow/skills/ |
~/.iflow/skills/ |
| Kilo Code | kilo |
.kilocode/skills/ |
~/.kilocode/skills/ |
| Kiro CLI | kiro-cli |
.kiro/skills/ |
~/.kiro/skills/ |
| Kode | kode |
.kode/skills/ |
~/.kode/skills/ |
| MCPJam | mcpjam |
.mcpjam/skills/ |
~/.mcpjam/skills/ |
| Mistral Vibe | mistral-vibe, vibe |
.vibe/skills/ |
~/.vibe/skills/ |
| Mux | mux |
.mux/skills/ |
~/.mux/skills/ |
| OpenCode | opencode |
.agents/skills/ |
~/.config/opencode/skills/ |
| OpenHands | openhands |
.openhands/skills/ |
~/.openhands/skills/ |
| Pi | pi |
.pi/skills/ |
~/.pi/agent/skills/ |
| Qoder | qoder |
.qoder/skills/ |
~/.qoder/skills/ |
| Qwen Code | qwen-code |
.qwen/skills/ |
~/.qwen/skills/ |
| Roo Code | roo |
.roo/skills/ |
~/.roo/skills/ |
| Trae | trae |
.trae/skills/ |
~/.trae/skills/ |
| Trae CN | trae-cn |
.trae/skills/ |
~/.trae-cn/skills/ |
| Windsurf | windsurf |
.windsurf/skills/ |
~/.codeium/windsurf/skills/ |
| Zencoder | zencoder |
.zencoder/skills/ |
~/.zencoder/skills/ |
| Neovate | neovate |
.neovate/skills/ |
~/.neovate/skills/ |
| Pochi | pochi |
.pochi/skills/ |
~/.pochi/skills/ |
| AdaL | adal |
.adal/skills/ |
~/.adal/skills/ |
手工安装
若目标宿主不在 npx skills add 的覆盖范围内，可手工复制技能目录：
# 1. 克隆具体技能包（每个包是独立仓库）
git clone https://github.com/full-stack-skills/vue-skills.git
# 2. 复制技能目录到目标宿主的技能路径
cp -r vue-skills/skills/vue3 ~/.claude/skills/ # Claude Code
cp -r vue-skills/skills/vue3 ~/.codebuddy/skills/ # CodeBuddy
cp -r vue-skills/skills/vue3 ~/.workbuddy/skills/ # WorkBuddy
技能目录内仅需 SKILL.md 即可被识别；references/、examples/、scripts/、assets/ 为可选配套资料。
相关文档
- README.md — 仓库主文档与技能目录
- LICENSE — Apache License 2.0 授权文本
- THIRD-PARTY-NOTICES.md — 第三方组件归属声明
- AGENTS.md — 技能编写与仓库约定