菜单
arkcli +connect：将 arkcli 内嵌的 AI skills 安装到本机检测到的所有 AI Agent 中，支持安装、列出已支持 agent、卸载。当用户需要将 arkcli 能力同步到 Claude Code 等本地 agent 时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/volcengine/ark-cli --skill arkcli-connect命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | arkcli-connect |
| version | 1.3.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 删除 ownership manifest 记录且未被用户修改的 ArkCLI skills |
arkcli +connect uninstall --path <skills-dir> | 只从指定目录删除 ownership manifest 记录且未被用户修改的 ArkCLI skills |
arkcli +connect uninstall --purge-prefix | 显式破坏性清理：删除所有检测目录中的 / 前缀目录或软链 |
ark-arkcli-arkcli +connect uninstall --path <skills-dir> --purge-prefix | 只在指定目录执行显式全前缀清理 |
⚠️ 没有
+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，仍需先确认 agent 范围；默认只删 manifest 记录且摘要未变化的 managed skillsarkcli +connect uninstall --path <skills-dir>--purge-prefix；它会删除用户手工维护的同前缀目录或软链arkcli-auth，与 +connect 无关（+connect 不需要认证）arkcli-configarkcli-code-example / arkcli-chat.arkcli-managed-skills.json 记录 ArkCLI 上次写入的精确名称、产品和目录摘要；每次安装都会用当前 CLI catalog 覆盖所有同名 Skill，并删除 manifest 中已退出当前 catalog 的旧 Skillark- / arkcli- 前缀也默认保留arkcli-managed-agent 若存在于旧 manifest，会作为退出 catalog 的旧 Skill 删除；canonical arkcli-agent 作为当前官方名称安装。这是统一 catalog 规则的结果，不再需要产品特判--path <skills-dir> 是隔离安装：相对路径按当前 PWD 解析，绝对路径原样使用；只在该目录收敛当前 catalog 和旧 manifest，并保留其他不同名条目。它不扫描 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 默认只删除 ownership manifest 中记录且摘要未变化的 managed skills；只有显式 --purge-prefix 才恢复旧式全前缀删除~/.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；legacy 私有目录只删除带旧 manifest 的 owned Skills，或与当前官方树逐字节一致的迁移副本，未知/修改过的同前缀条目保留list 只扫描本地文件系统，不写入、不联网、不需要认证npm install arkcli 时 postinstall 会自动跑 +connect：在能打开 /dev/tty 的交互式终端上按 authoritative catalog 规则更新检测到的所有 agent，无需用户确认；成功时只输出唯一安装目标数、对应 Agent 名称和安全卸载命令 arkcli +connect uninstall，不会逐目录展开进度明细。它不会执行 --purge-prefix。CI / 非交互终端 / 拿不到 /dev/tty 一律静默跳过；想完全静音可设 ARKCLI_SKIP_POSTINSTALL=1详细行为、错误码、输出示例见 references/arkcli-connect.md。