arkcli docs

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、调用归因前缀与命令选择顺序。 CRITICAL — 执行任何 docs 命令前，MUST 先用 Read 工具读取 references/commands.md；遇到报错 MUST 读取 references/failure-modes.md。

arkcli docs 只做一件事：把方舟官方文档变成可引用的事实来源。它不是通用搜索引擎，也不是 arkcli 自身用法的说明书。

下文 docs ... / resources list 等是命令路径缩写。给用户或工具的命令必须包含 arkcli 可执行文件名，说明文字放在命令外。复用已经选定的 MCP 配置，不用示例 URL 或占位值覆盖；只有已知真实端点且确需显式传递时才带端点参数。

下一步只给当前可执行的命令。 URL、位置等参数尚未返回时，不把后续读取加入命令列表；条件和备选方案用文字说明。MCP 即使返回 total_chunks，也先读取 next_chunk_start 指向的单块，再依据新响应决定下一步。认证失败时，当前步骤转交 arkcli-auth；登录完成后才恢复 Docs。 调用归因示例中的 <agent-id> 必须替换成实际宿主名；未知时用 unknown_agent，不要把未引用的尖括号占位符交给 shell。

唤起信号（When To Trigger）

整理方舟/豆包接入教程、调用指南或配置说明，即使用户只说“整理成文档发给我”、没有官方链接，也先由本 Skill 核实产品事实，再交给宿主的文档/附件工具排版交付。先列所需主题，未给路径时搜索对应官方资料并读取正文；不能先根据账号资源或 Key 列表写完整教程再补来源。代码示例按需委托 arkcli-code-example，不把“生成文档”自动理解为付费调用模型写作。

明确的官方文档请求、第三方客户端 GUI 中的方舟接入步骤（如 CC Switch 选豆包）或其他 skill 委托的产品知识问题也由本 skill 承接；先按下方反唤起清单确认最终目标。只转换用户已给材料的格式不要求重新检索。不要把 docs 当成不知道该用哪个命令时的兜底入口。

问 CC Switch 里如何选豆包时，优先定位对应套餐的官方 Claude Code「使用 CC Switch」章节，核对 GUI 槽位、专属 Key、Base URL 和 Model Name；不能把通用第三方工具文档的 /api/compatible 当成 Coding Plan 或 Agent Plan 的默认地址。用户未说明套餐时，分别说明已核实的 Coding Plan、Agent Plan 与按量接入条件，再请其选定；当前套餐支持的豆包模型名用对应 arkcli plans model-list --plan <plan> 校准。该控制面查询若因宿主凭证失败，只能给标明来源与套餐的文档示例，不能宣称是当前账号实时可选清单。