arkcli 共享执行协议:本 skill 是 arkcli 的统一规则入口,所有 arkcli-* skill 执行前应先读取。正文只放高频规则,身份解析、AK/SK 边界、API Key 恢复、实名闸门、profile 默认与漂移、临时执行上下文、版本检查与升级、全局 flags、故障分流等细节下沉到 references/ 按需读取。
用途:统一 CLI 与 Profile、命令路由与选择顺序、认证闸门、输出规则、安全规则、意图澄清与二次确认。
安装:npm i @volcengine/ark-cli -g(公开版)。
主要能力与用法:Agent 通过任意 arkcli-* skill 执行命令时必须加单命令环境变量前缀 ARKCLI_NO_UPDATE_NOTIFIER=1、ARKCLI_CALLER_TYPE=ai_agent、ARKCLI_CALLER_NAME=<agent-id>、ARKCLI_SKILL_NAME=<current-arkcli-skill>,每条子命令都要带,不能 export 到整个 shell。命令选择顺序:先用产品命令 arkcli <domain> <verb> 或 arkcli +<workflow>,有对应 reference 先读,产品命令不覆盖才走 arkcli api。认证闸门:先运行 arkcli auth status;火山登录用 arkcli auth login volc-sso,非 TTY 用 arkcli auth login --no-browser 两段式。输出全局 --format 支持 json、yaml、table、csv、jsonl、pretty,stdout 只放结构化结果,禁止按行或字节截断解析。安全规则:禁止输出完整 AK/SK、token、secret;写操作前确认意图;只有已注册 Action 才能通过 arkcli api 调用。高危操作返回 ExitValidation 且 type=requires_confirmation 时,属正常二次确认,用户确认后加 --yes 重试。
适用场景:arkcli 各类业务 skill 的共享前置规则、身份与配置核对、命令路由判断、认证与错误恢复、意图澄清和二次确认。
限制:arkcli 是产品 CLI,不是 OpenAPI Action 浏览器;Profile 不能切换编译产品;语音模型当前仅支持 models search 发现;根命令已删除 --project-name 与 --region。其余细节按 references/ 场景读取。