用途:为编码智能体设计或审查命令行工具(CLI),使其能在无人值守、可脚本化的环境下可靠运行。人类导向的 CLI 常因交互式提示、一次性输出大量文档、缺少可复制示例而阻塞智能体。
主要能力与建议模式:
- 非交互优先:所有输入都应能通过 flag 或其值表达,不依赖方向键、菜单或定时提示;缺少 flag 时才回退到交互模式,而非相反。例如用 mycli deploy --env staging 代替交互式选择环境。
- 分层可发现性:智能体逐步发现子命令(先 mycli,再 mycli deploy --help),不要每次运行都打印整本手册,让每个子命令自带文档。
- 可用的 --help:每个子命令都有 --help,且包含真实调用示例,示例比散文更利于模式匹配。
- stdin、flag 与管道:在合理处接受 stdin(如 cat config.json | mycli config import --stdin),避免奇怪的位置参数顺序,支持链式调用(如 mycli deploy --env staging --tag $(mycli build --output tag-only))。
- 快速失败与可操作错误:缺少必需 flag 时立即退出并给出清晰信息与正确示例,而不是挂起。
- 幂等性:智能体常重试,同一成功命令重复执行应安全(无操作或明确提示已完成),不产生重复副作用。
- 破坏性操作:提供 --dry-run 预览计划,提供 --yes / --force 跳过确认,同时为人类保留安全默认值。
- 可预测结构:统一模式,如资源+动词,service list、deploy list、config list 形状一致。
- 成功输出:返回机器可用数据,如 ID、URL、耗时,纯文本即可,避免只依赖装饰性输出。
审查现有 CLI 时检查:非交互路径、分层帮助、--help 示例、stdin/管道支持、带调用示例的错误信息、幂等性、dry-run、确认绕过 flag、命令结构一致性、结构化成功输出。
限制:资料未提供具体安装命令、平台支持、收费或价格信息,暂未提供。