从monorepo到51个独立仓库:full-stack-skills AI技能市场拆分背后的演化故事
从monorepo到51个独立仓库:full-stack-skills AI技能市场拆分背后的演化故事
full-stack-skills 是一个免费的 AI 技能市场,为 Claude Code、Codex 等 AI 编码智能体提供面向全栈开发的 Agent Skills 集合:788 个技能、51 个可独立安装的包、覆盖前端、后端、DevOps 与 AI 设计工具。这篇文章带你复盘它从一个 monorepo 拆分成 51 个独立仓库的演化故事——理解这段历史,你才能真正搞懂"按需安装 AI 技能包"的设计逻辑。
一个 monorepo 装不下 788 个技能?拆分前的三大痛点
拆分不是拍脑袋决定的。维护团队在 README.md 里明确列出了 monorepo 形态下的四个缺口:
| 痛点 | 具体问题 | 拆包后的解法 |
|---|---|---|
| 上下文溢出 | 一次性加载全部技能会超过 token 限制 | 通过 npx skills add 按包按需加载 |
| 版本锁定 | monorepo 强制所有技能协调发布 | 每个包独立版本管理与发布 |
| 领域深度 | 通用 AI 缺乏深度框架知识 | 15 个领域、788 个专业技能 |
| 可发现性 | 技能分散、难以查找 | 导航站统一入口 + 技能索引 |
其中最致命的是前两条:技能越多,智能体的上下文负担越重;任何一个包的更新,都可能牵动整个仓库的发布节奏。
拆分前的 full-stack-skills:460+ stars 的 monorepo 长什么样
在 2026 年 6 月迁移完成之前,full-stack-skills 是一个 460+ stars 的大型 monorepo。docs/repository-map.md 保留了拆分前的完整快照,可以一窥当时的规模:
skills/目录下有 42 个技能组(vue-skills、tauri-skills、t2ui-skills 等)- 仓库内共检出 422 个 SKILL.md 技能文件
.claude-plugin/marketplace.json配置了 40 个插件、411 个技能路径- 顶层还带着
adapters/(多平台适配器)、bundles/、dist/等聚合产物目录
当时的典型使用流程是:在 Claude Code 中执行 /plugin marketplace add 把整个 monorepo 添加为插件市场,再用 /plugin install 挑选技能包安装。
这个模式对新手很友好,但也正是问题所在——你安装的是一个"整仓市场",而不是"一个轻量技能包"。
2026 年 6 月迁移:51 个技能包如何独立成仓
2026 年 6 月,迁移完成。根据 README.md 的说明:"当前 788 个技能均位于独立仓库。本仓库现在是目录和导航站,所有现有 stars 和历史记录均保留在此。"
拆分后的结构在 PROVENANCE.md 中被定义为一个三层模型:
- Hub 层:partme-ai/full-stack-skills 本仓库——只保留目录、文档和平台指南,不含技能代码
- Packages 层:full-stack-skills 组织下的 51 个独立 Git 仓库,每个仓库独立版本化
- Skills 层:每个仓库内按
skills/<技能名>/SKILL.md组织,支持references/、examples/、scripts/等可选目录
仓库清单固化在 scripts/repositories.txt 中(从 1panel-skills 到 zig-skills 共 51 个),配套的 scripts/clone_repos.sh 脚本可以一键把全部技能包克隆到本地工作区,方便批量浏览。
许可证也随之细化为三层:Hub 与每个包均为 Apache-2.0,而源自第三方上游的技能(如 speckit-skills、部分 python-skills)保留原有 MIT 等许可——拆包让"逐技能追溯来源"第一次变得可行。
拆分带来的三个实际收益:按需、独立、最小上下文
按需安装:以前"装市场",现在"装包"。只想学 Vue?一条命令就够:
npx skills add full-stack-skills/vue-skills
甚至可以只装包里的某一个技能:
npx skills add full-stack-skills/vue-skills --skill vue3 --agent codex
独立版本:tauri-skills 发新版本不再阻塞 docker-skills 的更新,每个包有自己独立的发布节奏。
最小上下文:技能采用"渐进式披露"机制(见 README.md)——启动时智能体只加载技能名称和描述,识别到相关任务时才读取完整的 SKILL.md,需要细节时再深入 references/。上下文占用最小化,专业深度按需供给。
技能有多丰富:从 Mermaid 图表到 Tauri 桌面应用
拆分后的 51 个包横跨 15 个方向:前端框架(vue-skills、react-skills、svelte-skills)、后端框架(java-skills 39 个、rust-skills 29 个、python-skills 19 个)、跨平台桌面(tauri-skills 多达 52 个)、DevOps 与容器(docker-skills 16 个)、代码质量治理(codeguard-skills 68 个)等。完整清单可查 SKILLS_INDEX.md,每个包都标注了技能数与安装命令。
以 document-skills 中的 mermaid 技能为例,AI 智能体加载后就能直接为你生成甘特图、流程图与时序图:
这类"装完就能用"的效果,正是技能包独立发布想要保证的:你拿到的是与当前任务精确匹配的最小知识单元,而不是一整个仓库。
新手上手:最快 3 步安装第一个 AI 技能包
👇 完整说明见 QUICKSTART.md,生态全貌见 docs/skills-ecosystem.md。
- 准备环境:安装 Node.js / npm,在目标项目目录打开终端(无需克隆导航仓库)
- 预览再安装:先加
--list查看包内技能,确认后再安装:
npx skills add full-stack-skills/vue-skills --list
npx skills add full-stack-skills/vue-skills --skill vue3 --agent codex
- 验证:运行
npx skills list查看已安装技能;跨项目复用再加--global
总结:为什么这次拆分值得借鉴
full-stack-skills 的演化路径——monorepo 聚合 → 独立仓库矩阵 + 导航站——给所有"内容型"开源项目提供了一个可复制的模板:
- 内容规模超过上下文与发布协调的承载点时,就该考虑按领域拆包
- 原仓库保留 stars 与历史记录,转型为导航站,社区资产不流失
- 目录、脚本(scripts/repositories.txt)与来源文档(PROVENANCE.md)保证 51 个仓库依然"一处可查、一键同步"
从 422 个技能到一个仓库,到 788 个技能分布在 51 个独立仓库——full-stack-skills 拆掉的是仓库的边界,留下的是同一个 AI 技能生态。


