前言¶
影刀（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
