前言¶

Agent 要替用户操作电信侧的业务时，第一步就卡在登录上：要么让人手动复制粘贴验证码，要么自己拼一套扫码轮询逻辑。前者体验差，后者每个项目都要重写一遍，而且一旦 token 过期、返回 401，处理方式往往各不相同。

下面介绍的这个 Skill 把天翼账号的 AST 认证流程收敛成一条可复用的能力：扫码登录、查登录态、401 后重新认证、直接调用 /ast/verify、取 idToken，都可以由 Agent 统一完成，不需要业务方自己实现。

这是什么¶

天翼账号扫码登录ASTskills 是一个社区来源的 Skill，坐标 @user_990a4550/tyzh-qrlogin-skills，当前版本 2.0.2，维护方为 user_990a4550。

它解决的问题是：Agent 在执行任务时缺少一个稳定的天翼账号认证入口，需要反复处理扫码、登录态、token 刷新这些与业务无关的环节。这个 Skill 把这些环节包成一步，业务侧只需要表达“我需要用天翼账号身份做 X”。

核心能力¶

根据官方简介，这个 Skill 面向的是“需要天翼账号 AST 直连认证”的场景，覆盖以下动作：

1、登录与扫码登录：发起天翼账号登录，走二维码流程。
2、登录态查询：检查当前 AST 登录状态。
3、401 后重新认证：在鉴权失败时触发 reauth，而不是把错误直接抛回业务。
4、直接调用 /ast/verify：绕过常规流程，直接校验 AST。
5、取 idToken：获取天翼账号的 idToken，并带上业务方的 appId。
6、本地认证状态：读取本地 agent_session 的认证状态。

其中第 5 点值得说明：它不是只返回一个 token，而是要求带上业务 appId，因此可以直接被另一个 Skill 或插件消费。也就是说，它既可以作为独立工具，也可以作为其他能力的身份前置。

安装与启用¶

官方页面：https://api.skillhub.cn/user_990a4550/tyzh-qrlogin-skills
SkillHub 页面：https://www.skillhub.cn/skills/user_990a4550/tyzh-qrlogin-skills

本次写作时未能成功抓取上述页面正文，因此安装命令、目录约定、配置文件字段均未核实到，不在此给出。从资料看，该 Skill 声明 requires_api_key=false，即不需要额外配置 API Key；但是否还需要其他环境变量，资料中没有说明，请以官方页面为准。

使用方为 Cursor、Codex CLI 或 Claude Code 时，若三者对 Skill 的启用方式不同，本文未能逐一核实，同样建议以官方页面说明为准。

典型用法¶

以下场景直接对应官方简介中的触发条件，可以作为调用方的判断依据：

1、Agent 需要在执行任务前确认天翼账号身份，走扫码登录。
2、业务接口返回 401，Agent 需要先重新认证，再重试原请求。
3、某个其他 Skill 或插件需要一份带业务 appId 的天翼账号 idToken。
4、本地 agent_session 中已有认证状态，需要读取或复用。

调用方式取决于所接入的 Agent 运行时对 Skill 的调用约定，资料中没有提供可复现的命令行示例，此处不虚构。

适用场景与注意¶

适合的场景：业务依赖天翼账号体系，Agent 需要代替用户完成登录并持有有效 token；或者多个 Skill 共享同一套天翼账号身份，希望由一个入口统一维护登录态和刷新逻辑。

需要注意的点：

1、该 Skill 是社区来源，维护方为个人账号，采用前建议先审阅其实现再在生产环境使用。
2、版本为 2.0.2，后续接口若变动，认证行为可能随之变化。
3、评分与下载量以 SkillHub 页面为准，本次抓取失败，未能在写作时复核；请勿把历史数据当作长期稳定的质量指标。
4、它只解决认证，不解决具体业务接口，业务方仍需自行处理业务侧的鉴权和错误码。

结尾¶

这个 Skill 的价值在于把天翼账号的 AST 认证从每个项目里重复实现的样板代码，变成一步可调用的能力，尤其是 401 重认证和带 appId 的 idToken 这两点，能明显减少业务侧的胶水代码。它面向的是明确依赖天翼账号体系的 Agent 项目，如果你的链路不涉及天翼账号，就没有必要引入。

官方地址：https://api.skillhub.cn/user_990a4550/tyzh-qrlogin-skills