SuperAPI AI 工具集

agent-friendly-cli

智能体与模型

查看项目

更新于 10-15 16:46

技能介绍

用途:该技能用于创建新的 CLI 工具,或审计已有 CLI 是否对 AI 智能体友好,也可辅助在 CLI 与 MCP 之间做选择。包含 Create(新建 CLI)与 Audit(审计现有 CLI)两种模式;审计时逐项判定通过、失败或部分满足,并按阻塞问题优先给出具体修复建议;创建时从一开始就应用全部要求,并在写代码前先确认 CLI 与 MCP 的取舍。

CLI 与 MCP 选型:命令数量少于约 15 个、无状态操作、智能体有 shell 访问、关注 token 预算(MCP 会在系统提示中增加常驻开销)时选 CLI;单服务器后挂 50 个以上工具、需要有状态会话、智能体无 shell 访问、多智能体系统时选 MCP。

主要要求包括:结构化输出(--json 输出机器可读 JSON 到 stdout,警告与进度到 stderr,字段类型一致,时间用 ISO 8601、时长用秒);有意义的退出码(0 成功、1 一般失败、2 用法错误、3 资源未找到、4 权限拒绝、5 冲突);幂等性(优先 ensure/upsert,支持 --if-not-exists,否则冲突返回退出码 5);自文档化帮助(每个命令含真实示例、标明必选与可选参数、突出 --json、采用名词加动词结构如 docker container ls);可组合与管道(--quiet/-q 输出裸数据、--output json 与 --fields 限制体积、用 --selector 或重复参数批量操作);--dry-run 与 --yes/--force 无提示模式,并检测非 TTY 输入自动跳过提示或明确失败;可操作错误(含 error_code、回显失败输入、建议下一步、标明是否可重试);输入加固(拒绝路径穿越、控制字符与 shell 特殊字符、校验资源 ID、防止双重编码)。

限制:资料未提供该技能的安装、运行命令、依赖、授权方式与收费信息,也暂未提供具体实现细节。