Agent Skill

Agent Skill 是一份给 AI 编程助手（Claude Code、OpenCode、Codex、Cursor 等 75+ 款）阅读的「HAiNA CLI 使用说明书」。安装后，AI 就学会了完整的发布流程、TikTok Shop 硬规则与错误处置——你只需说一句话：

「用 HAiNA CLI 把 ./demo.mp4 发到我的 TikTok 账号」 「给这个产品 ID 挂车发布这条视频，发之前先跑一遍预审」

AI 会自己完成：查坐席拿账号 → 上传视频 → 发布 → 轮询到终态，全程不需要你贴任何 curl 示例。

本页是「CLI + Skill」路线（适合本地文件与 coding agent）。素材在公网 OSS、想要零本地运行时的纯远程接入，见 MCP 接入指南。

版本说明

Skill 与 CLI 同版本发布。推荐用方式一（haina skill install）安装——Skill 随 CLI 包分发，版本永远一致；旧脚本的命令 flag 在新版 CLI 中保留兼容别名，升级不会打乱已有流程。

用其他方式安装时，若 agent 执行命令报「未知命令」，说明本机 CLI 版本过旧：运行 npm update -g @hainaio/cli 升级后，再跑一次 haina skill install --yes 重装即可。

安装

三种方式任选：

# 方式一：CLI 一键安装（自动探测本机已装的 AI agent，支持 --global / --agent / --yes）
npx -y @hainaio/cli skill install

# 方式二：skills 生态标准安装器（公共镜像仓）
npx skills add hainaio/skills

# 方式三：tarball 直链（自有域名分发，国内访问稳定，免登录）
npx skills add https://cli.haina.io/skills/haina-cli.tgz

桌面客户端（WorkBuddy / 豆包 / QoderWork 等）手动导入用 zip 包（免登录直链下载后，在客户端里「上传/导入技能」）：

https://cli.haina.io/skills/haina-cli.zip

项目级安装（跟随仓库，团队共享）与全局安装（--global，跨项目可用）都支持。

Skill 教了 AI 什么

• 两条主流程：TikTok 发布（上传 → 发 URL → 轮询终态）与 TikTok Shop 挂车（上传拿 fileId → 拉商品 → 可选预审 → 发布 → 轮询）
• TikTok Shop 硬规则：fileId 一次性消耗且绑定上传账号、锚点文案规范、预审语义——AI 不会犯「重发复用 fileId」这类错误
• 凭据纪律：Token 只走环境变量，AI 不会把密钥写进你的代码
• 错误处置：每个错误码/退出码对应的处理动作（套餐过期提示续费、限流自动等待等）

和 CLI 的关系

Skill 是「知识」，CLI 是「能力」：Skill 教 AI 什么时候敲什么命令，CLI 负责把命令正确执行。两者同版本一起发布，永不脱节。如果你的环境不想装 CLI，Skill 里也附了完整的接口速查，AI 可以降级为直连 HTTP API。