解剖 Academic Forge 技能注册表registry/skills.json 结构与 sparse-checkout 安装机制【免费下载链接】AcademicForgeOne Forge, All Skills: A curated skill collection for academic writing and research. 点开即用按需配置的一站式学术研究skills平台。项目地址: https://gitcode.com/gh_mirrors/ac/AcademicForgeAcademic Forge 是一个一站式学术 skill 选配与安装平台为 Claude Code / OpenCode / Codex 提供科研写作、图表可视化、蛋白质结构预测等现成技能包。它的核心枢纽是技能注册表 registry/skills.json一份约 7000 行的 JSON 目录描述了 12 个技能包、306 个可安装条目并用install字段声明每个条目的拉取方式整仓克隆或 sparse-checkout 稀疏检出让安装脚本 scripts/forge-install.sh 能够读表即装。本文带你完整解剖这份注册表的数据结构、两种安装机制的原理以及配套的校验与发布链路。️ 注册表顶层结构一切皆技能包打开 registry/skills.json顶层只有一个键{ skills: [ /* 12 个技能包记录 */ ] }每个技能包pack记录包含以下字段字段作用示例id全局唯一标识安装命令中用它引用claude-sciencename/summary展示名 中英双语简介en/zh15 个流程型 skill规划、调试、TDD…author/repository/license来源归属信息MITskill_count/stars技能数量、仓库星标数149/29933tags分类标签供站点筛选[science, research]install安装指令核心见下文{method: sparse-checkout, ...}post_install安装后钩子动作[clean_ads]is_collection/sub_skills可选是否为集合、子技能明细149 个子技能其中stars字段由 scripts/refresh-stars.mjs 定期刷新保证站点展示的数据是新鲜的。⭐ 安装机制git-clone 与 sparse-checkout 双轨注册表最有价值的部分是每个条目的install对象目前支持两种method方式一git-clone整仓克隆install: { method: git-clone, url: ... }适用于整个仓库就是一个技能或需要完整内容的集合型包如 149 个科研技能的 Scientific Agent Skills、98 个的 AI Research Skills。脚本会执行浅克隆--depth 1把.git目录删掉后保留纯文件——快且省空间。方式二sparse-checkout稀疏检出install: { method: sparse-checkout, url: ..., sparse_path: skills/claude-science }当目标仓库庞大但你只需要其中一两个目录时sparse-checkout 就是最优解。scripts/forge-install.sh 的实现分四步部分克隆git clone --depth 1 --filterblob:none --sparse——只拉取提交历史骨架不下载任何文件内容blob 按需加载指定检出路径git sparse-checkout set sparse_path让工作区只物化目标目录复制产物把检出目录的内容拷入你的项目默认.claude/skills/id清理临时目录整个临时检出区随后删除不留痕。以本地维护的claude-science包为例它正是对本仓库自身做稀疏检出sparse_path: skills/claude-science一条命令就能把 32 个内置科研技能装进你的项目——这就是无需订阅、跨 agent 通用背后省带宽的关键。 两种方式的取舍仓库小而独立 →git-clone仓库大而只需要局部 →sparse-checkout。注册表里 4 个包走稀疏检出8 个包走整仓克隆。 集合型包与 sub_skills306 个条目的由来大集合包通过is_collection: truesub_skills数组展开为可单独安装的子条目技能包子技能数典型 sparse_pathScientific Agent Skills149skills/adaptyvAI Research Skills98按仓库目录划分Nature Skills15skills/nature-academic-searchClaude Science本地维护32skills/claude-science/algorithmic-art每个sub_skills条目有自己的id带前缀如cs.algorithmic-art防止跨包重名、双语summary、category/subdiscipline分类以及独立的install对象。这意味着你可以整包安装也可以精确到单个技能——--skills cs.diffdock只会检出那一个目录。12 个包 300 余个子条目正是站点 site/public/index.slim.json 中 306 个条目的来源。子条目还允许声明post_install钩子例如 Scientific Agent Skills 的clean_ads安装后自动从所有SKILL.md中剔除源仓库夹带的推广章节scripts/forge-install.sh 中的post_clean_ads函数实现。 从注册表到终端一条安装命令的旅程站点端的类型定义在 site/src/lib/registry.ts与 JSON 结构一一对应。你在选配页勾选技能后site/src/lib/install-command.mjs 会拼出一条可复制的命令# macOS / Linux--tool 决定目标工具claude/opencode/codex curl -sSL 脚本地址/forge-install.sh | bash -s -- \ --tool claude \ --skills humanizer,claude-science脚本执行流程一览下载注册表从远端拉取skills.json到临时文件scripts/forge-install.sh按 id 查表内置的json_extract同时匹配顶层包与sub_skills子条目按 method 分发走克隆或稀疏检出分支写入工具目录claude→.claude/skills/opencode→.opencode/skills/codex→.codex/skills/汇总报告输出OK / SKIP / FAIL清单已存在同名技能自动跳过加--force覆盖。Windows 用户有等价的 scripts/forge-install.ps1参数名大小写略异-Tool/-Skills。回归测试则覆盖在 scripts/tests/ 下如 forge-install-multiple-sparse-checkouts.sh 专门验证一次安装多个稀疏检出包的场景。✅ 注册表如何保持可信校验与约束一份被多方消费安装脚本、站点、AI agent的目录数据质量至关重要。scripts/validate-registry.mjs 对每个条目做四重检查id 全局唯一跨包与子条目查重避免安装命令歧义method 合法只允许git-clone或sparse-checkout且后者必须带sparse_path本地包落盘验证凡指向本仓库的稀疏检出路径必须在磁盘上真实存在如skills/claude-science目录杜绝目录里写了、仓库里没有的幽灵条目翻译一致性summary.zh不得与summary.en相同防止漏翻译。校验不通过即退出码为 1可无缝接入 CI。配合站点发布产物 site/public/skills.json就形成了仓库内单一数据源 → 校验 → 站点展示 安装消费的完整闭环。 小结与延伸阅读想深入了解去哪里看全部 12 个技能包定义registry/skills.json安装机制实现bashscripts/forge-install.sh安装机制实现PowerShellscripts/forge-install.ps1注册表校验规则scripts/validate-registry.mjs站点类型定义与命令生成site/src/lib/ 下的 registry.ts 与 install-command.mjs本地 32 个 Claude Science 技能skills/claude-science/快速上手指南QUICKSTART.md一句话总结registry/skills.json把技能从哪里来、怎么装、装到哪全部声明化sparse-checkout 则让大仓库小技能的安装又快又省。理解了这份注册表你就理解了 Academic Forge 一键安装的全部秘密。【免费下载链接】AcademicForgeOne Forge, All Skills: A curated skill collection for academic writing and research. 点开即用按需配置的一站式学术研究skills平台。项目地址: https://gitcode.com/gh_mirrors/ac/AcademicForge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考