Menu
arkcli +connect：将 arkcli 内嵌的 AI skills 安装到本机检测到的所有 AI Agent 中，支持安装、列出已支持 agent、卸载。当用户需要将 arkcli 能力同步到 Claude Code 等本地 agent 时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | arkcli-connect |
| version | 1.1.0 |
| description | arkcli +connect：将 arkcli 内嵌的 AI skills 安装到本机检测到的所有 AI Agent 中，支持安装、列出已支持 agent、卸载。当用户需要将 arkcli 能力同步到 Claude Code 等本地 agent 时使用。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli +connect --help"} |
前置： 先用 Read 读 ../arkcli-shared/SKILL.md 获取共享安全规则。
把 arkcli 内嵌的 skills 同步到本机 AI Agent（Claude Code、Cursor、Gemini CLI 等）的 skills 目录。纯本地文件操作，不需要认证。
| 调用 | 说明 |
|---|---|
arkcli +connect | 默认行为：安装到所有检测到的 agent |
arkcli +connect --path <skills-dir> | 安装到指定的本地 skills 目录（项目级 / 自定义路径），不扫描 agent、不改全局目录 |
arkcli +connect list | 只读：列出支持的 agent 与检测状态 |
arkcli +connect uninstall | 破坏性：从所有 agent 卸载 |
arkcli +connect uninstall --path <skills-dir> | 删除目标 skills 目录下所有 ark- / arkcli- 前缀目录或软链（含用户手工维护的同前缀条目），不扫描/修改其他 agent 目录 |
⚠️ 没有
+connect install/+connect setup/+connect sync/+connect remove等子命令；安装就是默认行为，不要凭直觉补 install。--path是 flag，不是子命令。
arkcli +connect，建议先 arkcli +connect list 预检arkcli +connect --path <skills-dir>，例如 arkcli +connect --path .claude/skills；--path 接收具体 skills 目录，不是项目根目录arkcli +connect list，不要顺手装arkcli +connect uninstall，先要求用户明确确认（破坏性，会按 ark- / arkcli- 前缀 rm -rf agent 目录下所有同前缀 skill）arkcli +connect uninstall --path <skills-dir>；只作用于该目录，但会删除其中所有 ark- / arkcli- 前缀目录或软链（含用户手工维护的同前缀条目）arkcli-auth，与 +connect 无关（+connect 不需要认证）arkcli-configarkcli-code-example / arkcli-chatark- / arkcli- 前缀的子目录（清掉历史遗留 skill，如已废弃的 ark-experience、arkcli-experience-video 等），再把当前内嵌 skill 写入--path <skills-dir> 是隔离安装：相对路径按当前 PWD 解析，绝对路径原样使用；只清理该目录下 ark- / arkcli- 前缀的目录或软链（含用户手工维护的同前缀条目），再复制当前内嵌 skill。它不扫描 agent、不清 legacy 私有目录、不删除 byted-ark-* conflicting skills、不 patch Claude/opencode 等 harness 配置byted-ark-seedance-skill / byted-ark-seedream-skill（按精确名匹配，不误伤其他 byted-*）。原因：它们的 description 带"推荐优先"+逐字触发词，会在"生图/生视频"意图上压过 arkcli +gen，且自身要独立 ark- API Key，赢了路由反而失败。移除后生成类意图统一落 arkcli +gen（用登录态 profile 凭证，跟视频一样能成）。日志显式打印 removed N conflicting (...)，非静默。要保留它们：arkcli +connect --keep-conflictinguninstall 同样按 ark- / arkcli- 前缀清理，不依赖"当前 binary 里有的 skill 名"——历史遗留同样能清掉~/.codex/skills(CODEX_HOME) 和共享的 ~/.agents/skills；Pi 同时扫 ~/.pi/agent/skills 和共享的 ~/.agents/skills。若两处都装 arkcli，会把每个 skill 列两遍或报同名冲突。因此 +connect 把 Codex / Pi 的 skill 都装进共享的 ~/.agents/skills(与 cline/warp 去重成一份)，靠 ~/.codex / ~/.pi/agent 目录存在来检出对应 agent；并在每次 +connect 时清掉 legacy 私有 skills 目录里的 arkcli(只清 arkcli/seed，gocli 等其它 skill 不动)。这样每个 arkcli skill 只出现一次list 只扫描本地文件系统，不写入、不联网、不需要认证npm install arkcli 时 postinstall 会自动跑 +connect：在能打开 /dev/tty 的交互式终端上直接把内嵌 skills 装到检测到的所有 agent，无需用户确认；CI / 非交互终端 / 拿不到 /dev/tty 一律静默跳过；想完全静音可设 ARKCLI_SKIP_POSTINSTALL=1详细行为、错误码、输出示例见 references/arkcli-connect.md。
arkcli doctor 诊断入口：用于火山方舟 Ark 报错、资源状态、用量配额、性能指标、错误码解释与修复建议；覆盖 doctor、doctor error、doctor infer-endpoint、doctor model、doctor metrics。用户给 Ark 错误码或错误 JSON、ep-xxx 接入点、模型名，问为什么报错、怎么修、状态/健康、用量/配额、限流、错误率、P99、Cache 命中率、接入点慢/挂、模型是否可用时使用；用户说诊断、体检、健康检查、排查、自助修复、看指标/监控也使用。模型名加失败、慢、超时、限流、异常、健康、配额等体检语义时走 doctor model，不因 seedream/seedance/生成视频关键词误触发 arkcli-gen。内容审核、敏感内容、PolicyViolation 等拦截诊断也归 doctor。安装、登录、profile、认证配置问题归 arkcli-shared 或 arkcli-auth。
火山方舟 Ark 图片/视频生成入口：用户要生图、画图、生成图片/视频、图生图、图生视频、参考图/视频/音频生成，或明确使用 seedream/seedance 创作新内容时使用 arkcli +gen。+gen 按当前 profile 的可用资源与模型 supported_params 生成；图片同步返回，视频提交后返回 task_id/status，需用 --wait 或 arkcli gen get/list 轮询并下载结果。反触发：用户问失败原因、失败率、模型健康、持续慢/超时/限流、配额是否够、内容审核/敏感内容/PolicyViolation 拦截怎么解决时，走 arkcli-doctor 的 doctor model 或 doctor error，不走本 skill。单条视频 queued/还在跑通常是异步任务未完成，仍用 gen get/list 查结果；跨任务统计性失败或持续异常才转 doctor。
arkcli helper:把 Claude Code / Codex / OpenCode / OpenClaw / Trae 配到火山方舟 Plan。用户说给当前或某个 Agent 配 MCP、豆包搜索、联网搜索、dataPro、OpenViking 时,用 `arkcli helper mcp`(只注入 MCP,不改 model);要连 model/provider 一起配用 `helper configure`;查状态用 `helper list`;移除注入用 `helper reset`。MCP 仅 Agent Plan 支持:个人版 agent-plan 配豆包搜索、dataPro、OpenViking 数据面/控制面;团队版 agent-plan-team 只配豆包搜索 + dataPro。Codex 支持 profile/global 配置范围;Trae 仅注 MCP,支持 `--scope project`。`helper supabase` 不是 MCP,用于安装 byted-supabase-cli + skill 并注入火山登录态。反触发:安装 arkcli skills → arkcli-connect;登录/401/鉴权 → arkcli-auth;生图生视频 → arkcli-gen。
arkcli 推理接入点**管理**能力：对**已有** Endpoint 做获取、列表、启动、停止、删除、更新（生命周期管理 + 启停 + 销毁）。优先使用产品命令 `arkcli infer endpoint ...`，而不是直接调用 Raw API。**反触发（重要）：用户说『创建/新建/create/部署/deploy 一个 endpoint/接入点』这类新建接入点的意图，一律走 arkcli-deploy（`+deploy`），不要用本 skill 的 `infer endpoint create`**；本 skill 的 `create` 仅用于脚本化 / CI / 需要无护栏的可预测 raw CRUD 行为（不做复用检查、不渲染示例）、且明确要绕过 +deploy 工作流护栏的场景。TTS/ASR/语音模型连 raw create 也不要引导，只能转 models search 说明 arkcli 不支持 Endpoint 创建。
ARK 套餐管理(Agent Plan / Coding Plan,个人版 + 企业版):查询持有 / 购买 / 续费 / 模型清单 / 轮换 APIKey,**以及企业版席位的全部管理操作**:列出席位(`plans team seat-list`)、给员工分配席位(`plans team seat-assign`)、查谁绑了哪个 seat、轮换席位 APIKey(`plans team rotate-apikey`)。命中关键词:套餐 / 买 / 续费 / 列席位 / 看 seat 绑定 / 谁绑了哪个 seat / 给员工分席位 / 解绑 / 团队席位 admin 视图 / 轮换 APIKey。**用量类问题(还剩多少额度 / 用了几成 / 每个 seat 用了多少)走 [arkcli-usage](../arkcli-usage/SKILL.md)。**动词路由:**列 / 绑 / 分 / 轮换 / 解绑** → 这里;**用 / 消耗 / 多少** → arkcli-usage。另含 harness-status:只读查看本机 AI Agent(claude-code/codex/opencode/openclaw/trae)上 Agent Plan 内置 MCP(豆包搜索/dataPro/OpenViking)装没装、key 就没就绪;命中:我的 MCP 装好了吗 / 查 MCP 安装状态 / 看 agent 上的 MCP / harness 状态。
arkcli 认证管理：交互式登录、Volc SSO 登录、查看状态、退出登录、生成 ARK API Key (apikey)、以及云开发机/CI 用 `arkcli init-volc` 从 VOLC_INIT_* 环境变量无交互引导 platform profile。0.1.16 起 SSO 登录走 Gate 1+2 自动绑定 Profile 切面 (type/region/project/owner_trn)；AK/SK login 通道暂关。当用户需要初始化凭证、排查鉴权问题、切换认证方式、生成或重选 ARK API Key、或在已注入凭证的环境无交互引导时使用。反触发：用户问 TTS/ASR/语音模型能力、接入或调用时，不要引导 `auth apikey`，只转 models search 说明 arkcli 当前仅支持广场发现。