前言¶
影刀（ShadowBot）的日常操作多在圖形界面或控制台裏完成。要在腳本、自動化流水線或 AI Agent 裏觸發登錄、查狀態、管任務與觸發器，往往得自己拼接口或點界面，成本高且難復現。下面介紹的 Skill「影刀 CLI」，把 Agent 引導到官方命令行入口 shadowbot.shell-cli.exe，在 Windows PowerShell 下做可覈對、可執行的 CLI 操作，而不是讓模型臆造子命令或參數。
這是什麼¶
「影刀 CLI」是 SkillHub 上的社區 Skill（座標 @user_5dd04a33/shadowbot，當前版本 0.0.2，分類 office-efficiency）。它面向已安裝影刀、且本機存在 shadowbot.shell-cli.exe 的用戶：當需要認證登錄、切換模式、健康檢查、控制台應用/任務/觸發器/消息/擴展、Studio、UI 動作或配置讀寫時，由 Agent 通過該 Skill 的說明，只執行經可執行文件自身幫助信息驗證過的命令與 flag。
發佈者爲 SkillHub 用戶 user_5dd04a33；Skill 標註 requires_api_key=false，不依賴額外 API Key 配置。
核心功能¶
依據官方簡介，Skill 覆蓋的能力包括：
- 認證與模式：
auth/login、運行模式切換。 - 系統狀態：系統狀態與健康檢查（health / state 類操作）。
- 控制台側：應用（app）、任務（task）、觸發器（trigger）、消息（message）、擴展（extension）等相關 CLI 操作。
- Studio 與 UI：Studio 操作、UI 動作。
- 配置：配置的讀取與寫入。
使用原則寫死在 Skill 說明裏：從 shadowbot.shell-cli.exe 自身發現子命令與參數，Agent 只執行已覈對過的命令與 flag，避免編造 CLI 用法。
安裝與啓用¶
安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行完整安裝或僅 CLI：
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
安裝「影刀 CLI」Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：
skillhub install user_5dd04a33/shadowbot --dir <skills 目錄>
常見路徑（以 SkillHub 安裝文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可將提示詞交給 AI，讓其按 SkillHub 安裝說明 安裝 @user_5dd04a33/shadowbot。
運行環境前提¶
Skill 假定在 Windows PowerShell 中調用 shadowbot.shell-cli.exe。本機需已安裝影刀且 CLI 可執行文件在 PATH 或 Skill 約定路徑下可訪問；具體路徑以你本機影刀安裝爲準，Skill 正文未固定安裝目錄。
典型用法¶
官方資料未給出固定業務示例子命令，而是強調「從可執行文件發現命令」。可復現的流程如下。
- 在 Windows PowerShell 中定位
shadowbot.shell-cli.exe（影刀安裝自帶）。 - 通過可執行文件自帶的幫助或子命令列表查看當前版本支持的命令與 flag（例如常見的
--help或子命令help，以實際輸出爲準）。 - 在 Cursor 等 Agent 中啓用本 Skill 後，用自然語言描述目標（如登錄、查健康狀態、列出任務、改配置），由 Agent 根據 Skill 規則只執行上一步已驗證過的 CLI 調用。
示例形態（佔位，須以你本機 shadowbot.shell-cli.exe 幫助輸出爲準）：
shadowbot.shell-cli.exe --help
# 將 <subcommand> 替換爲幫助裏出現的真實子命令
shadowbot.shell-cli.exe <subcommand> [flags]
適用場景與注意¶
適合誰
- 已在 Windows 環境使用影刀，希望用 PowerShell / Agent 做重複運維、巡檢、任務與觸發器管理的人。
- 希望 AI 操作影刀時遵守「只跑已驗證 CLI」約束的團隊。
限制與注意
- 平臺綁定 Windows PowerShell；Linux/macOS 上無法按 Skill 設計直接使用同一套 exe。
- Skill 不替代影刀本體安裝；CLI 能力上限取決於本機
shadowbot.shell-cli.exe版本與其幫助文檔。 - SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 1527，安裝計數 0；社區來源，升級與維護節奏以發佈者爲準。
- Agent 仍可能誤讀幫助輸出；關鍵生產操作應在測試環境先跑通同一命令再自動化。
結尾¶
「影刀 CLI」把影刀自動化收斂到官方 shadowbot.shell-cli.exe 與 PowerShell，適合需要 CLI 驅動登錄、狀態檢查、控制台與 Studio 操作、配置讀寫等場景。安裝與座標見 SkillHub：
- 技能頁：https://www.skillhub.cn/skills/user_5dd04a33/shadowbot
- API 座標：https://api.skillhub.cn/user_5dd04a33/shadowbot
