操作场景
在 AI Agent 落地过程中，Agent 所依赖的原子能力单元（Skill）需要有统一的注册、存储、版本与分发机制，避免同一能力在多个 Agent 中重复配置、无法复用的问题。
通过北极星 Skill Registry，您可以将 Skill 作为一等资源进行统一管理，包括 Skill 的注册与存储、版本管理、生命周期管理、安全审核、分发与发现、命名空间隔离以及 AI 辅助优化，使 Skill 能够在多个 Agent 之间复用，并对外提供标准化的能力发现能力。
前提条件
已创建北极星引擎实例，且实例版本支持 Skill Registry 能力。
已完成命名空间的创建与规划。
功能范围
本期 Skill Registry 覆盖以下能力：
能力项 | 说明 |
Skill 注册与存储 | 支持将 Skill 作为独立资源注册到注册中心并持久化存储 |
版本管理 | 支持 Skill 的版本管理 |
生命周期管理 | 支持 Skill 从创建到上下线的全生命周期状态管理 |
安全审核 | 支持对 Skill 进行安全审核 |
分发与发现 | 支持 Skill 的分发与被发现 |
命名空间隔离 | Skill 以命名空间为隔离单元进行管理 |
AI 辅助优化 | 提供 AI 辅助的 Skill 优化能力 |
操作步骤
步骤1：进入 Skill 管理页面
1. 登录 注册配置治理中心控制台。
2. 在实例列表中单击目标北极星实例 ID，进入实例详情页。
3. 在左侧导航栏，选择 AI 注册中心 > Skill 管理，进入 Skill 管理页面。
4. 在页面上方可以按需选择子导航页签：
我的 Skill：当前用户在当前命名空间下创建的 Skill，具有完整管理权限。
SkillHub：已发布到 SkillHub 的公共 Skill 市场，只读，仅支持查看详情和下载。
步骤2：新建 Skill
1. 在我的 Skill 页签，单击工具栏左侧的新建 Skill，打开新建 Skill 弹窗。
2. 在弹窗中选择创建方式：
方式一：手动填写
按顺序填写以下字段后，单击提交完成创建；若单击关闭，则放弃创建。
字段名 | 是否必填 | 约束 |
命名空间 | 必填 | 单选目标命名空间 |
名称 | 必填 | 请输入 Skill 名称，不超过 64 字符，同一命名空间内名称唯一，创建时实时校验 |
版本号 | 必填 | Skill 版本号信息 |
描述 | 选填 | 不超过 1024 字符 |
作者 | 选填 | - |
标签 | 选填 | 单个 Tag 不超过 32 字符，最多 20 个 |
示例 | 选填 | 单条不超过 512 字符，最多 10 条，回车添加 |
SKILL.md 内容 | 必填 | 直接输入 SKILL.md 内容（Markdown） |
发布方式 | 必填 | 保存草稿：仅保存为草稿，稍后可在列表中上线 直接上线：创建后立即上线，可被调用 |
方式二：上传 Skill 文件
1. 在命名空间模块，单选目标命名空间。
2. 在上传文件模块，点击上传 .zip 文件（须包含 SKILL.md），系统自动解析并回填所有字段，您可二次确认后提交。
压缩包内容需符合以下规范：
{skillId}.zip├── SKILL.md # 必须，frontmatter + 指令内容├── skill.json # A2A AgentSkill 标准格式└── scripts/└── README.md # 可选
3. 按需选择发布方式，单击弹窗底部的操作按钮完成创建：
保存草稿：仅保存为草稿，稍后可在列表中上线。
创建并上线：创建后立即上线，可被调用。
4. 单击提交完成创建。若单击关闭，则放弃创建。
步骤3：管理我的 Skill
在我的 Skill 页签可以查看并管理 Skill 列表。
上线 Skill
1. 在我的 Skill 页签，单击
2. 按需选择需要上线 Skill 的版本号（状态为草稿或已下线），单击右侧操作列的上线。
3. 在弹窗中，确认后单击确认上线即可。
编辑 Skill（可选）
1. 在我的 Skill 页签，单击
2. 按需选择需要编辑 Skill 的版本号（状态为草稿），单击右侧操作列的编辑。
下线 Skill（可选）
1. 在我的 Skill 页签，单击
2. 按需选择需要下线 Skill 的版本号（状态为已上线），单击右侧操作列的下线。
3. 在弹窗中，确认后单击确认下线即可。
删除 Skill（可选）
警告：
删除后，无法恢复，请谨慎操作。
删除 Skill：在我的 Skill 页签，按需选择需要删除的 Skill，单击右侧操作列的删除，在弹窗中，确认后单击删除即可。
删除 Skill 下的某个版本：在我的 Skill 页签，单击
步骤4：查看 Skill 详情
1. 在我的 Skill 页签中，单击目标 Skill 名称，进入 Skill 详情页。
2. 在基本信息模块查看以下内容：Skill 名称、版本号、创建人、创建时间、描述、命名空间、可见范围、标签、更新时间。
3. 在基本信息模块右侧可执行以下操作：
版本选择器：下拉切换历史版本，切换后下方页签内容同步展示对应版本的 SKILL.md 与 AgentSkill JSON。
下载 ZIP：单击可下载当前版本的 ZIP 包。
编辑：草稿状态的 Skill 可通过单击编辑，进入编辑 Skill 弹窗，修改 Skill 信息。
4. 在下方页签栏查看 Skill 内容：
SKILL.md 预览：代码高亮展示 SKILL.md 原始内容，右上角提供复制按钮。
AgentSkill 格式：展示 A2A AgentSkill 标准 JSON，右上角提供复制 JSON 按钮。
说明：
此 JSON 格式遵循 A2A AgentSkill 规范，当 Skill 挂载到 Agent 时，将自动写入 AgentCard 的 skills[] 数组中。
版本历史：查看与管理版本快照。
步骤5：发布 Skill 到 SkillHub
1. 在我的 Skill 页签中，找到状态为在线且未发布到 SkillHub 的 Skill。
2. 在操作列单击发布到 SkillHub，在弹出的窗口，单击确认发布。发布后，该 Skill 将在 SkillHub 中对所有用户可见。
3. （可选）如需撤回，可以在操作列单击从 SkillHub 下架，在弹出的窗口，单击确认下架。下架后，该 Skill 恢复为原有的命名空间可见性，SkillHub 移除该条目，已下载的内容不受影响。
步骤6：从 SkillHub 浏览与下载 Skill
1. 在 Skill 管理页面，单击 SkillHub 页签，进入 Skill 市场页。
2. 使用页面工具查找 Skill：
在搜索框中输入关键词，支持按名称、描述、标签等全文检索。
使用标签筛选下拉框按标签过滤。
按下载量或更新时间排序。
3. 在卡片列表中查看 Skill 信息：图标、Skill 名称、描述、标签、作者、下载量等信息。
4. 单击查看详情，可以进入 Skill 详情页查看详情后，单击下载 ZIP；或单击下载 ZIP 直接下载。
