项目简介

SkillHub 是管理 Agent 技能分发与治理的自托管注册中心。技能作者提交带有 SKILL.md 的技能包，注册中心保存版本并执行访问控制、扫描和审核流程；使用者通过网页发现技能，再通过 CLI 将文件安装到目标 Agent 的技能目录。本页面向首次了解产品的使用者、作者和部署方，说明职责边界与对象选择，不代替具体操作手册。

注册中心的职责与边界

注册中心解决技能来源分散、版本难以统一、访问范围与发布过程缺少管理入口的问题。它管理的是可分发的技能文件、版本及其治理记录，不负责在服务端直接执行已安装技能。

图：注册中心负责接收、治理与分发；技能安装后的加载和执行由目标 Agent 环境完成。

操作	注册中心承担的职责	使用者或作者承担的职责
提交与发布	校验技能包，按配置推进扫描、审核及发布	提供指令、依赖说明和可核查的内容；处理拒绝或失败结果
发现与下载	按资源状态和访问权限提供搜索、详情及可下载版本	核对用途、来源、版本和目标环境，不将可见详情等同于可安装
安装与执行	CLI 下载文件并维护本地安装记录	确认 Agent 已发现技能，配置运行依赖，并验收执行结果
更新与治理	管理版本以及隐藏、归档等治理状态	核对本地修改与更新计划；已下载文件不会因远端治理操作被自动收回

技能不是托管运行中的应用；安装不等于启动服务。扫描结果和审核记录也不是执行效果或合规认证：扫描只能反映对应任务与策略下的检查结果，技能的适用性仍需在实际 Agent 环境中验证。

区分技能、技能套装与套装 Bundle

三种对象服务不同阶段，不能相互替代。技能套装（Skill Suite）固定一组成员技能的精确版本，并指定一个成员作为入口；套装 Bundle（Suite Bundle）是作者批量导入成员和套装定义的格式。

对象	保存或描述的内容	与相邻对象的区别
技能	一个以 SKILL.md 为核心的技能包及其版本	可独立安装；关联某个技能套装不要求安装全部成员
技能套装	成员坐标、精确版本和入口技能	是安装集合，不是工作流执行引擎；安装后成员仍为独立目录
套装 Bundle	SUITE.yaml 与待上传的成员目录，或已发布成员的版本引用	是创作与导入输入，不是本地 Agent 的执行程序，也不绕过成员审核

例如，会议资料处理需要“材料接收”和“摘要生成”两个技能。单独使用摘要功能时，只需安装摘要技能；共同分发时，可创建技能套装，固定各成员版本并将材料接收设为入口。成员尚在本地、需要同时上传时，作者才需要准备套装 Bundle。此例用于解释对象关系，不代表注册中心存在同名可安装资源。安装技能套装不会自动执行上述两步，实际协作由入口及成员指令与 Agent 决定。

对象定义可核查技能套装成员模型及套装 Bundle 定义。

根据目标选择对象与入口

目标	选择	判断依据与后续操作
安装一个技能完成独立任务	技能	无需固定其他成员版本；从快速开始完成安装与 Agent 发现验证
将多个技能按固定版本共同分发	技能套装	需要固定成员组合与入口；在技能套装中核对成员可安装状态
同时上传多个本地技能并组成套装	套装 Bundle	需要导入定义、预览差异并创建成员版本；阅读Bundle 导入
管理可见范围、成员与审核	命名空间与治理流程	平台角色不等同于命名空间角色；先阅读命名空间的权限前置

只有技能安装和使用需求时，不需要先部署注册中心或准备套装 Bundle。发布需求应按“准备技能包、提交、扫描、审核、确认发布”的实际路径处理，不能将上传结束当作全部流程结束；入口见发布与版本管理。

部署形态与技术组成

已有可访问实例时，可直接使用其网页和 CLI。自托管部署则需要维护服务、数据库、会话存储及技能文件存储，并配置所需认证与扫描能力。外部身份、扫描器和其他外部服务是否启用，以实例配置为准；自托管不代表所有外部请求均被禁用。

组成	技术或实现	作用与配置边界
网页与服务端	React、Vite；Java、Spring Boot	网页提供操作入口，服务端执行接口及业务规则
数据库与会话存储	PostgreSQL、Redis	保存业务记录并支持服务端会话；必须与技能文件一起纳入运维设计
技能文件存储	本地文件或 S3 兼容存储	后端按部署配置选择实现；存储选型不等于已有数据已完成迁移
部署路径	部署脚本、release Compose、Kustomize、Helm	路径各有配置入口，不应混用升级命令或持久化配置

部署组成以release Compose及后端模块定义为依据。需要自托管时，从文档导航选择部署路径；集成开发者应区分注册中心接口与实际 Agent 执行环境，接口职责见Runtime 集成。