mirror of
https://github.com/partme-ai/full-stack-skills.git
synced 2026-09-14 18:20:58 +08:00
12dd2a92ad
响应 awesome-workbuddy#406 审计记录提出的两点:
1. 授权资质
- LICENSE 文件原本是第三方组件归属声明(Third-Party Notices),不含项目授权正文
- 现拆分为:LICENSE(Apache License 2.0 完整正文)+ THIRD-PARTY-NOTICES.md(原内容)
- README 许可证段同步更新,明确两者的关系
2. 宿主兼容性
- PLATFORM_GUIDE.md 重写:移除已失效的 fskill CLI / adapters 相关内容
(该适配器已从仓库移除,旧文档描述的命令与目录均不存在)
- 改为基于 npx skills add 的标准安装说明 + 手工复制指引
- 新增宿主兼容性状态表:Claude Code(已验证)/ Codex(可安装)/
CodeBuddy、WorkBuddy(可安装、未系统测试、无官方认证关系)
- 明确声明 WorkBuddy / CodeBuddy 不是本项目背书宿主
3. 新增 PROVENANCE.md
- 记录三层授权结构(hub / package / skill)
- 技能级许可例外清单(5 个第三方 MIT 技能含版权方、8 个一方 MIT 技能、12 个指针式声明)
- 47 个包级清单(技能数 / 许可 / 仓库)
- 再分发条款与自查命令
- 已知缺口(含本次修复记录)
同时修复 vue-skills/skills/pinia/LICENSE.txt(原内容为 404: Not Found 抓取残留)。
6.7 KiB
6.7 KiB
宿主兼容性说明(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 — 技能编写与仓库约定