前言¶

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