arkcli-agent
Installation
SKILL.md
arkcli agent
CRITICAL — 开始前 MUST 先读取 ../arkcli-shared/SKILL.md。
当用户需要创建、查询、调试或联通 ARK Managed Agent 时使用本 skill。核心原则：先用稳定产品命令，不要直接猜 OpenTOP Action；Session 运行时资源、事件、线程、Files API 走数据面直联；MCP OAuth 登录先查后端 provider，再用 arkcli agent +mcp-login。
执行前按“先选路径”读取对应 reference；只读相关 reference，不需要一次性加载全部细节。用户请求如果已经明确是创建、复制、挂文件、聊天、MCP 登录等写操作，完成必要确认/消歧后直接执行，不要只给命令建议。
创建 Agent 的最小决策表
| 用户输入 | AI Agent 的处理 |
|---|---|
| 未指定模型 | 只执行一次 arkcli agent model list --query "<用户业务意图>" --primary-only --format json，从完整结构化结果中取得候选；不要省略 query 值、不要用管道/重定向截断输出、不要凭印象拼模型 ID |
| 未指定 Skill | 先查本账号 custom skill；没有合适候选再查 market/SkillHub skill |
| 给出本地 Skill zip | 先调用 agent skill create --zip，拿到返回的 skill-... ID 和版本后再创建 Agent |
| 未指定工具 | 使用 CLI 注入的完整默认工具集；显式传 --tool 时全量替换默认工具 |
| 未指定环境 | 创建 Session 时自动选择当前项目最新环境；没有可用环境才提示创建或传入环境 ID |
| 创建成功 | 必须回读 agent agent get <agent-id> --format json，展示服务端最终的 Model、System、Tools、Skills、McpServers 和扩展配置 |
| 用户期待 Agent 回复 | 短请求使用 +new session ... --message 或 events send ... --stream；大 payload / 长耗时任务使用 events send --poll，或 send 立即返回后按 cursor 轮询 events / 使用 +tail，不要让所有任务都阻塞等待 |