Agent-CLI 设计

定义

专为 AI Agent 优化的命令行界面设计范式。区别于传统面向人类的 CLI 设计，Agent-CLI 针对 LLM 的认知特点（概率选择、树搜索、幻觉倾向）进行交互优化。

要点

• Agent 使用 CLI 的本质是树搜索：--help → 解析 → 拼命令 → 看退出码
• 核心原则：Noun-Verb命令结构、长参数优先、输出是契约、幂等设计
• CLI vs MCP 优势：按需查询（--help）而非全量注入 schema
• Agent 天然弱点：大小写短参数、交互式提示、幻觉参数、非结构化输出

示例

Docker CLI 是典范：container/image/volume 是名词，ls/rm/create 是动词。同一动词在不同名词下语义一致。

相关概念

• Noun-Verb命令结构
• 幂等设计
• Skills系统
• Agent Harness

参考资料

• Agent-CLI设计原则〔待补〕
• agent-cli-guide
• clig.dev