arkcli +understand

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、API Key 错误恢复、配置排查与命令选择顺序。 CRITICAL — 执行 +understand 之前，MUST 先用 Read 工具读取 references/arkcli-understand.md（命令/flag/返回值/错误）与 references/sub-skills.md（12 个 sub-skill 的用途与期望输出形态）。禁止凭印象拼命令。

核心概念

• +understand 不是 12 套实现，而是 1 个引擎 + 一层语义：底层引擎就是 +chat 用的数据面 Responses API；每个 sub-skill 只是一条配方 {模态, 默认模型, 内置 system prompt}。sub-skill 之间的唯一差异，是注入到 Responses instructions 字段的那段专家 system prompt。
• 命令形态：arkcli +understand <sub-skill> --input @file [prompt]。
  • args[0] 命中注册表（12 个之一）→ 当作显式 sub-skill，其余位置参数当 prompt 叠加在内置 prompt 之上。
  • args[0] 不命中 → 整段位置参数都当 prompt，服务端按首个 --input 的文件模态自动路由到该模态的默认 sub-skill。
• 必须有 --input：sub-skill 是「对某个文件做理解」，没有 --input 会直接 missing_input 报错。纯 prompt 无法推导配方。
• 返回值与 +chat 完全一致：arkcli 扁平 schema {id, model, content, reasoning_content, usage}，不是 Responses 原生 output[].content[].text 嵌套。详见 references/arkcli-understand.md 的「返回值」段。
• 多模态上传：image/video/doc 由 SDK file:// preprocessor 自动走 Files API；audio 是特例——内联为 base64 data URL，上限 25MB。详见 reference。

快速决策（understand vs chat vs gen）