Bundle uds-skill-auth inside the uds-auth plugin for single-package handoff.

Move the public auth helper skill under uds-auth/skills and update docs to point there instead of the repo-root skills tree.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-09-08 23:46:11 +08:00
parent c5c6089f89
commit b60c626d41
8 changed files with 51 additions and 94 deletions

View file

@ -1,60 +0,0 @@
---
name: uds-skill-auth
description: UDS 技能认证公共库。其它依赖 UDS 登录的 skill 必须安装本 skill,通过其 scripts/uds_skill_auth.py 取凭证或出站调用。需现场已安装 uds-auth 插件且用户已扫码登录。
---
# uds-skill-auth(认证公共 Skill)
本 skill **不是业务能力**,而是给其它 skill 用的公共库。
## 现场依赖
```text
1. 安装并启用 uds-auth 插件
2. 安装本 skill(uds-skill-auth)到 skills 目录
3. 用户扫码登录
4. 再安装/使用业务 skill(如通讯录、发信等)
```
## 给其它 Skill 用
业务 skill 的 Python 脚本里,把本 skill 的 `scripts/` 加入 `sys.path` 后:
```python
from uds_skill_auth import resolve, request, UdsAuthError
# Mode Creds:拿到 empNo + token(可写进程内 EMP_NO/AUTH_VALUE)
creds = resolve()
# Mode Outbound(推荐):Host 代贴鉴权头
out = request("POST", "https://icenterapi.zte.com.cn/...", headers={...}, body={...})
```
定位本 skill 目录的推荐写法(与业务 skill 同级安装时):
```python
from pathlib import Path
import sys
def load_uds_skill_auth():
here = Path(__file__).resolve().parent
# .../skills/<业务skill>/scripts → .../skills/uds-skill-auth/scripts
for skills_root in [here.parents[1], *here.parents]:
candidate = skills_root / "uds-skill-auth" / "scripts"
if (candidate / "uds_skill_auth.py").is_file():
sys.path.insert(0, str(candidate))
import uds_skill_auth
return uds_skill_auth
raise RuntimeError("未找到 uds-skill-auth,请先安装该 skill")
```
也可设置环境变量 `UDS_AUTH_HELPERS` 指向本 skill 的 `scripts` 绝对路径。
## 环境变量(Agent 已注入,勿教模型打印密钥)
- `DSH_SESSION_ID` — 当前会话
- `DSH_WEB_URL` — Harness Web 地址(用于拼 `/uds-auth`)
## 标准文档
完整契约见插件仓库:`uds-auth/docs/skill-auth-standard.zh.md`。