SuperAPI AI 工具集

cli-agent-experience

智能体与模型

查看项目

更新于 10-16 04:53

技能介绍

用途:审计一个 CLI 工具对 AI 智能体的友好程度,输入可以是当前目录下的源码、已安装的二进制名称或 GitHub 仓库地址,输出为基础等级、加分提示和按优先级排列的修复清单。

主要能力:按 11 个维度评分,每个 0-3 分。基础维度决定等级(满分 21):结构化输出(是否有 --json、默认输出是否省 token)、退出码(是否有意义的递进码)、非交互模式(能否完全无人值守、是否检测 TTY)、自文档(--help 是否含示例、必选与可选是否清晰)、可操作的错误(错误码、回显失败输入、恢复提示)、一致的语法(名词-动词层级与命名一致性)、token 效率(默认简洁、分页、--limit/--field)。加分维度仅作提示、不扣等级(满分 12):幂等性、可组合性、dry-run、智能体教学。等级区间:A 18-21、B 14-17、C 10-13、D 6-9、F 0-5。加分维度存在领域上限,达到该领域可能的上限时标记为 X/3。

使用方式:先识别 CLI 工具,再收集证据(运行 <tool> --help 与子命令帮助、检查 --json/--quiet/--dry-run/--yes/--force 等标志、阅读输出格式化与错误处理代码、在安全只读时运行示例命令),然后逐维度评分,最后输出报告并进入修复环节,询问用户是全部修复、挑选条目修复,还是仅将报告作为参考。

适用场景:评估命令行工具是否便于 AI 智能体调用与自动化编排。

限制:加分维度受领域影响,浏览器、聊天、API 包装器、REPL 等工具的上限不同;评分需阅读源码或实际运行命令,资料中未提供具体安装命令与收费信息。