SuperAPI AI 工具集

arkcli-api-explorer

编程与开发

查看项目

更新于 10-16 08:08

技能介绍

用途:当现有产品命令与业务 skill 确实无法覆盖需求时,通过 arkcli api 查看或调用本地已注册的 ArkCLI Action,用于低频、专业或高风险的底层 Action 验证与兜底,不可作为默认入口。

主要能力:枚举本地注册的 Action(arkcli api --list 或 arkcli api);用 --params 传入 JSON 调用已注册 Action;用 --dry-run 做纯本地客户端预览;用全局 --transform 按 gjson 路径提取关键字段;--debug 输出请求/响应调试信息到 stderr。

使用方式:先读 ../arkcli-shared/SKILL.md,再读 references/arkcli-api.md,然后按顺序执行。示例:arkcli api --list;arkcli api model.list_foundation_models --params '{"PageSize":10,"PageNumber":1}' --dry-run;去掉 --dry-run 后执行真实调用。检查认证用 arkcli auth status,配置问题转 arkcli-auth / arkcli-config。注意 payload 内的 "DryRun":true 是后端字段,未加 CLI --dry-run 仍会发出真实网络请求。

适用场景:产品命令无法覆盖且不值得做成标准命令;验证已注册 Action 的输入输出契约;确认 registry 中是否存在某 Action;开发中新增 operation 后验证 --list 与可调用。

限制:api --list 仅列二进制本地注册的 Action,不是公开 API 目录,也不提供完整 OpenAPI schema;参数须来自同版本 reference、官方契约或可访问的 req/resp JSON tag,缺失确定契约应停止而非猜测;同一 Action 因 MissingParameter 连续失败两次且无确定值时应停止试错;只读优先,写操作须二次确认;不要因某 Action 存在就反推新增顶层 skill 或 cmd/ 命令。