@numa-tech/numa 1.14.42 → 1.14.44

package/skills/numa-wecom/numa-skill.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "name": "numa-wecom",
+  "version": "1.1.0",
+  "dependencies": [
+    {
+      "name": "numa-cli",
+      "version": "1.1.0"
+    }
+  ]
+}

package/skills/numa-wecom/references/cli-bootstrap.md

@@ -0,0 +1,11 @@
+# 基础 Skill 依赖
+
+本 Skill 的公共 CLI 运行指引由 `numa-cli@1.1.0` 维护。先用宿主 Skill 目录/加载工具定位并完整读取它的 SKILL.md，按任务需要读取其启动参考；不要只相信名字匹配，不使用其他来源的同名 Skill。
+
+如果没安装或宿主暂时看不到依赖，明确询问：“此功能需要 numa-cli 基础 Skill，是否现在为当前 Agent 安装？”用户拒绝就停止，不循环重试。已安装但不可见时请刷新 Skill 列表或重新打开会话，不重复覆盖安装。
+
+用户同意后，优先使用现有 `numa --cli-version`。缺失时，在 Node/npm 可用且符合环境执行审批的前提下，说明首次会下载官方 npm 缓存，再用 `npx -y @numa-tech/numa@latest --cli-version` 查询实际版本并固定后续入口。Windows 可用同安装目录的 `npx.cmd`，不改执行策略；Node 缺失由环境维护者安装，不读取/转换任何凭据。
+
+沿用这个入口检查 `auth status --json`、`config --show --json`，确认身份和任务环境。只从本业务 Skill 的原 namespace/instance inspect 已发布的 `numa-cli@1.1.0`，核对 `skills install --help` 后显式指定同一 agent/scope 安装。未发布、无权访问或运行时不支持时报告阻断，不能换源或擅自升级 CLI。安装文件不等于自动加载，成功后重新加载基础 Skill 才继续业务操作。
+
+该兜底仅用于恢复依赖；完整运行、身份、安全及错误处理规则以 numa-cli 为准。依赖关系由包内 numa-skill.json 声明，旧 CLI 可能忽略声明，因此始终核对实际依赖存在。

package/skills/numa-wecom/references/machine-auth.md

@@ -0,0 +1,36 @@
+# 环境提供的机器身份
+
+机器认证由 Numa CLI 内置的 `client_credentials` 支持处理，凭据由 CI、容器或凭据管理设施预先提供。本 Skill 不下载、解析、转换凭据，不自行获取 Token，也不提供启动 CLI 的认证包装脚本。
+
+## 环境契约
+
+以下是环境维护者配置 CLI 时使用的变量，不是要求 Agent 读取或展示其值：
+
+| 变量 | 用途 |
+| --- | --- |
+| `NUMA_KEYCLOAK_AUTH_MODE` | `client_credentials` |
+| `NUMA_KEYCLOAK_CLIENT_ID` | 用户指定的 confidential Client ID |
+| `NUMA_KEYCLOAK_ISSUER_URL` | 本项目 PRD issuer |
+| `NUMA_BACKEND_BASE_URL` | 本项目 PRD Business API |
+| `NUMA_KEYCLOAK_CLIENT_SECRET` | 由凭据设施安全注入；不写入命令行或仓库 |
+| `NUMA_KEYCLOAK_CLIENT_SECRET_FILE` | 可替代 Secret 环境变量的受保护文件路径，由 CLI 读取 |
+
+两种 Secret 来源不可同时配置。受保护文件应仅允许当前运行用户访问，是普通文件而非符号链接，内容为单个 Secret 文本，不是平台下载的 JSON。运行环境还应隔离人类配置与其他租户的 profile/API 覆盖配置。
+
+缺少配置时，请环境维护者提供，不在 Skill 中补写读秘密的脚本、转换 JSON 或导出环境变量。不要读取 Token 缓存、复用浏览器 Cookie，也不要静默切换到人类会话。
+
+## 检查与使用
+
+直接运行已核实版本的标准 CLI：
+
+```sh
+numa auth status --json
+numa config --show --json
+numa wecom capabilities --json
+```
+
+先核对安全状态输出：认证模式为 `client_credentials`、Client ID 与用户指定值一致、API 为 `https://apps-gw-prd.mcisaas.com/mci-devops-platform`，issuer 为 `https://kc.mcisaas.com/auth/realms/numa-realm`。不符或未配置时停止；不要用读取凭据正文、环境变量转储或缓存文件代替安全状态检查。
+
+机器 Token 代表服务账号，不代表人类用户，不触发默认用户登录入组。配置就绪不证明 API 授权；capabilities 成功后，按主 Skill 先查询收件人，再发送用户授权的消息。401/403 不通过添加角色、组或扩大权限解决。
+
+发送结果不明时，保持原机器身份与原 request-id，用 `numa wecom status --request-id NOTICE_ID --json` 查询，不重新发送或更换请求号。

package/skills/numa-skills/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Numa Skills 与 MCP"
-  short_description: "查询、安装及治理发布企业 Skills 与 MCP"
-  default_prompt: "使用 $numa-skills 完成当前任务，先检查身份、目标和可用能力。"

package/skills/numa-skills/evals/evals.json

@@ -1,38 +0,0 @@
-{
-  "skill_name": "numa-skills",
-  "evals": [
-    {
-      "id": 1,
-      "prompt": "把 release-helper 安装到当前 Cursor 项目。现有目录可以覆盖，保留备份；不要改 Nacos 配置。",
-      "expected_output": "先核对身份/配置/capabilities并 inspect 精确目标；按已有授权处理实际冲突，不重复索要覆盖许可；默认 project scope；不修改实例、凭据或路由，验证来源/版本/完整性",
-      "files": [],
-      "assertions": [
-        "先核对身份/配置/capabilities并 inspect 精确目标",
-        "按已有授权处理实际冲突，不重复索要覆盖许可；默认 project scope",
-        "不修改实例、凭据或路由，验证来源/版本/完整性"
-      ]
-    },
-    {
-      "id": 2,
-      "prompt": "我有平台授予的自定义角色，请上传并发布 docs-agent 1.3.0；没有历史 reviewer 角色也能做吗？",
-      "expected_output": "依据 capabilities 和后端授权，不按历史角色名拒绝或授予；上传和提交精确版本；当前提交者不能自审自发；报告真实申请状态，不绕过403或直接操作Nacos",
-      "files": [],
-      "assertions": [
-        "依据 capabilities 和后端授权，不按历史角色名拒绝或授予",
-        "上传和提交精确版本；当前提交者不能自审自发",
-        "报告真实申请状态，不绕过403或直接操作Nacos"
-      ]
-    },
-    {
-      "id": 3,
-      "prompt": "把 internal-docs MCP 装到 ChatGPT 和 Claude，Router 显示不可用。",
-      "expected_output": "inspect 资源与Router健康，不安装下游直连地址；ChatGPT使用远程HTTPS OAuth，Claude可用bridge；不伪称安装成功；基础设施修复交给numa-nacos，不自动重绑Router",
-      "files": [],
-      "assertions": [
-        "inspect 资源与Router健康，不安装下游直连地址",
-        "ChatGPT使用远程HTTPS OAuth，Claude可用bridge；不伪称安装成功",
-        "基础设施修复交给numa-nacos，不自动重绑Router"
-      ]
-    }
-  ]
-}