---
name: numa-ai-registry
description: 旧 Numa AI Registry Skill 的兼容指引。仅在用户明确使用 numa-ai-registry 旧名称或要求迁移该 Skill 时使用；Skills/MCP 安装与发布改用 numa-cli，Nacos 实例、凭据、namespace 路由与 Router 管理改用 numa-nacos。
---

# Numa AI Registry 兼容指引

原职责已拆分：

- `numa-cli`：Skills 与 MCP 查询、安装、版本锁定、同步、资源维护、审批发布及客户端连接。
- `numa-nacos`：Nacos 实例、凭据配置、namespace/默认路由、Router 基础设施管理与诊断。

按实际任务加载对应 Skill；混合任务按这两个边界分别处理。不要根据请求中出现 Nacos 一词，就把 Skill 安装归入基础设施管理。

若新 Skill 尚未安装，先 `npx -y @numa-tech/numa@latest auth status --json`、`npx -y @numa-tech/numa@latest config --show --json` 和 `npx -y @numa-tech/numa@latest registry capabilities --json`，核对身份、环境与可用 namespace，再用 `npx -y @numa-tech/numa@latest skills list/inspect/install --help` 检查命令。读取并安装授权库中的新 Skill 后继续；新 Skill 尚未发布时明确报告，不声称已具备它，也不照搬旧发布权限。

历史 `npx -y @numa-tech/numa@latest registry` 命令、`.numa/registry.json`、`registry.lock.json`、profile 的 `aiRegistry` 字段以及 `/api/v1/ai-registry/**` 保留兼容。不得为改名迁移配置、删除旧远端资源、修改路由或扩大授权。

权限依据服务端当前 capabilities、功能 view/edit 和 namespace 业务授权，不再按历史普通用户角色名判定。不要读取 token 缓存、索取 Nacos 凭据、绕过 403；两人制发布禁止提交者自审自发。