前言¶
開發或運維騰訊雲輕量應用服務器(Lighthouse)時,常見路徑是打開控制台逐項點選,或在本地寫腳本調 Open API。前者打斷編碼上下文,後者要記接口名、參數和鑑權方式。若你已經在 Cursor、Claude Code 等 Agent 環境裏寫代碼,更希望用自然語言完成「查實例、建機器、部署應用、管資源」這類操作,而不是反覆切換瀏覽器和文檔。
下面介紹 SkillHub 上的 Tencent Cloud Lighthouse(@tencent-adm/tencentcloud-lighthouse-skill)。它在 Agent 識別到 Lighthouse 相關意圖時加載,把輕量服務器的檢查、創建、管理、部署等能力收斂到同一套 Skill 指令裏,由發佈方 Tencent Cloud Lighthouse 維護,來源標註爲 enterprise。
這是什麼¶
Tencent Cloud Lighthouse 是一則面向大模型 Agent 的 Skill,遵循通用 SKILL.md 格式,當前版本 1.0.2,在 SkillHub 分類爲 it-ops-security。
它解決的核心問題是:當用戶提到 Lighthouse、輕量應用服務器或輕量服務器,或明確要求檢查 / 創建 / 管理 / 部署 Lighthouse 實例、把應用部署到 Lighthouse、管理相關資源時,Agent 能按 Skill 內嵌的流程與約束調用騰訊雲能力,而不是泛泛猜測控制台步驟。
Skill 標籤含 requires_api_key=true,使用前需準備騰訊雲 API 密鑰;具體密鑰字段名與配置方式以安裝後的 Skill 文檔爲準,本文不展開未在公開頁面出現的配置項。
核心功能¶
以下能力均來自 SkillHub 頁面與預抓取資料中的觸發條件描述,未單獨列出的接口名、CLI 子命令不作補充。
- 實例生命週期:檢查、創建、管理 Lighthouse 實例(與用戶自然語言中的「查機器、開實例、改配置」等意圖對應)。
- 應用部署:將應用部署到 Lighthouse 實例。
- 資源管理:管理 Lighthouse 相關資源(與實例、部署鏈路配套的雲側對象)。
Skill 的加載時機由簡介中的 Load when 規則決定:用戶提及 Lighthouse、輕量應用服務器、輕量服務器,或提出上述檢查 / 創建 / 管理 / 部署類請求時啓用。
安裝與啓用¶
安裝 SkillHub CLI¶
若尚未安裝 CLI,可先檢查:
command -v skillhub && skillhub --version
未安裝時,可用官方腳本(完整安裝含默認 Skill;僅需 CLI 時加 --cli-only):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill¶
SkillHub 頁面給出的安裝提示爲:根據 SkillHub 安裝與優先源配置,安裝 @tencent-adm/tencentcloud-lighthouse-skill。
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認會裝到 ./skills/,Agent 可能無法識別:
skillhub install tencent-adm/tencentcloud-lighthouse-skill --dir <你的 Agent skills 目錄>
常用路徑示例(摘自 SkillHub 安裝文檔):
| Agent / 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中可寫爲:
skillhub install tencent-adm/tencentcloud-lighthouse-skill --dir ~/.cursor/skills/
安裝後若 Agent 未立即識別新 Skill,按所用客戶端說明重啓或刷新 skills 加載(SkillHub 文檔提到錯誤目錄時可能需要重啓)。
API 密鑰¶
標籤 requires_api_key=true 表示本 Skill 依賴騰訊雲 API 訪問。請在騰訊雲控制台創建並妥善保管 SecretId / SecretKey,並按 Skill 包內說明配置到 Agent 環境或 Skill 要求的變量中;勿將密鑰寫入倉庫或對話日誌。
典型用法¶
公開 SkillHub 頁面未附帶逐步截圖級教程,可復現的用法主要是觸發 Skill + 自然語言任務:
- 確認 CLI 已安裝且 Skill 已裝入對應
--dir。 - 配置好 API 密鑰(見 Skill 內文檔)。
- 在 Agent 對話中直接說明意圖,例如:
- 「列出我在廣州的 Lighthouse 實例」
- 「創建一臺輕量應用服務器並安裝 Docker」
- 「把當前項目部署到指定的 Lighthouse」
Agent 在匹配觸發詞或上述類請求時會加載 Tencent Cloud Lighthouse,再按 Skill 定義的步驟調用雲 API 或給出可執行命令。具體每一步的命令輸出以 Skill 1.0.2 正文爲準;若與控制台文檔衝突,以 Skill 發佈方說明爲準。
也可將 SkillHub 頁面上的安裝提示詞發給 AI,讓其按 skillhub.md 完成安裝:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@tencent-adm/tencentcloud-lighthouse-skill`。
適用場景與注意¶
適合誰
- 已在用騰訊雲 Lighthouse,希望用 Agent 減少控制台切換的開發者或小團隊。
- 需要在對話中串聯「查實例 → 改配置 → 部署應用」的運維 / 全棧同學。
- 使用 Cursor、Claude Code、Codex 等支持 Skill 目錄的客戶端的用戶。
限制與注意
- 必須 API 密鑰:無密鑰或權限不足時,Skill 無法代你調用雲 API。
- 權限邊界:Secret 應對應最小 IAM / CAM 策略;生產環境變更建議仍有人工確認。
- 版本:本文依據 v1.0.2;升級可用
skillhub對同一座標更新,並再次指定--dir。 - 數據口徑:SkillHub 展示評分約 100000、下載 28692、安裝 1395(抓取時點),僅作選用參考,不代表 SLA 或功能完備度。
結尾¶
Tencent Cloud Lighthouse 把輕量應用服務器相關的檢查、創建、管理、部署和資源管理意圖,收斂到 enterprise 來源的一則 Skill 裏,適合已在 Agent 工作流中操作騰訊雲的用戶。安裝走 SkillHub CLI,記得 --dir 與 API 密鑰兩項。
- SkillHub 頁面:https://www.skillhub.cn/skills/tencent-adm/tencentcloud-lighthouse-skill
- 安裝說明:https://skillhub.cn/install/skillhub.md
- 座標:
@tencent-adm/tencentcloud-lighthouse-skill