前言¶

在 Cursor、Claude Code 等环境里让模型帮你「出图、出音视频、跑 Coze 工作流或对话」，常见问题是：模型不知道 coze 子命令怎么写、认证怎么配、哪些场景该走 CLI 而不是瞎编接口。把平台能力写成 Agent Skill，等于给模型一份可检索的操作说明。下面介绍社区 Skill coze cli（坐标 @user_6c29a21a/coze-cli，当前版本 2.0.0），它把 Coze CLI 的用法收敛进标准 SKILL.md，在相关意图出现时由 Agent 自动加载。

这是什么¶

coze cli 是 SkillHub 上的社区 Skill（来源：community，发布者 user_6c29a21a，分类 design-media）。定位是 Coze CLI（coze 命令）的能力与使用说明：当用户要生成 AI 图片/音频/视频、执行 Coze 工作流、进行聊天对话或做认证管理时，应触发本 Skill，由 Agent 按文档调用命令行，而不是凭空构造未核实的 API。

Skill 元数据标注 requires_api_key=true，即实际调用 Coze 能力前需要配置有效的 API 密钥；具体字段与登录方式以 Skill 内 SKILL.md 为准。

核心功能¶

以下能力均来自 SkillHub 官方简介，未在资料中出现的子命令或参数不在本文展开。

1. 图片生成：通过 Coze CLI 发起 AI 图片生成相关操作。
2. 音频生成：通过 CLI 生成或处理音频类媒体任务。
3. 视频生成：通过 CLI 完成视频生成链路。
4. 聊天对话：使用 CLI 侧的聊天能力，与 Coze 对话服务对接。
5. 工作流执行：调用已在 Coze 平台配置的工作流。
6. 认证管理：处理 CLI 与平台之间的认证、密钥等管理步骤。

触发场景（官方描述）：用户明确要求生成 AI 图片/音频/视频、使用 Coze 工作流、聊天对话、认证管理时，Agent 应启用本 Skill。

安装与启用¶

SkillHub 推荐通过其 CLI 安装，并必须把技能装进当前 Agent 能识别的 skills 目录（否则默认落在 ./skills/ 且可能不被加载）。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（含默认 Skill）或仅 CLI：

# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装 coze cli¶

将坐标中的包名换成本 Skill 的发布坐标：

skillhub install @user_6c29a21a/coze-cli --dir <当前 Agent 的 skills 目录>

常见 Agent 的 skills 路径（摘自 SkillHub 安装说明，以你本机实际配置为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可以在对话里让 AI 按官方提示安装，原文为：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_6c29a21a/coze-cli。

3、API 密钥¶

标签 requires_api_key=true 表示依赖 Coze 侧密钥。安装完成后，在 Skill 正文或 Coze 官方文档中完成 coze 的登录/密钥配置，再执行生成或工作流类命令。

典型用法¶

本 Skill 面向 Agent 编排，而不是替代你手写 shell 脚本。可复现的「用法」在资料层体现为两类：

通过 SkillHub 安装并放入正确目录

skillhub install @user_6c29a21a/coze-cli --dir ~/.cursor/skills/

安装后重启或刷新 Agent，使 skills 目录生效。

在对话中触发 Skill

当用户提出与简介一致的需求时，例如「用 Coze 工作流跑一遍」「生成一张 AI 图」「配置 coze 认证」，Agent 应读取 SKILL.md 中的 coze 命令说明并逐步执行。具体子命令、参数与示例以 Skill 包内文档为准；本文不列举未在公开页面出现的 CLI 细节。

适用场景与注意¶

适合谁

• 已在或计划使用 Coze 平台 与 coze CLI，并希望 Cursor 等 Agent 稳定走命令行而非幻觉接口的开发者。
• 需要在对话中完成 多媒体生成、工作流、聊天、认证 等一体化 Coze 操作的团队。

限制与注意

• 社区 Skill（community），维护节奏与 Coze 官方产品变更需自行关注；版本以 SkillHub 为准（当前 v2.0.0）。
• 必须配置 API Key；无密钥时 CLI 调用会失败。
• SkillHub 页面统计（截至抓取）：评分 100000，下载 724；安装量等以商店实时数据为准。
• 仅搜索/安装单个 Skill 时，按 SkillHub 文档可直接执行第三节命令，无需额外改「优先源」配置。

结尾¶

coze cli 把 Coze 命令行能力写进 Agent 可加载的 Skill，在图片/音频/视频、聊天、工作流与认证等场景下减少「模型瞎编命令」的风险。需要安装或查阅元数据时，可打开 SkillHub 页面：

• SkillHub：https://www.skillhub.cn/skills/user_6c29a21a/coze-cli
• 坐标页（API）：https://api.skillhub.cn/user_6c29a21a/coze-cli