Vercel 发布 CLI 设计指南：让命令行同时服务人类与 AI Agent

JohnPhamous · x · 2026-11-06

Vercel 发布《CLI Design Guidelines》，一份关于如何构建「人能学会、程序能组合、Agent 能可靠操作」的命令行界面的手册。核心主张：每个命令都要回答四个问题——作用于什么（先展示解析出的目标）、会改变什么（风险操作前展示）、发生了什么（真实结果反映在输出与退出码）、下一步是什么（给出一条可直接执行的命令）。

七条原则包括：能力优先（同一能力在 CLI/API/SDK/MCP/仪表盘语义一致）、一个概念一个名字、行动前先精确解析目标（绝不猜测）、交互/同意/输出格式三者独立（prompt 需要 TTY，--yes 只给同意不供数据，--json 只选格式，管道不改变三者）、stdout 可管道、错误可行动、绝不静默破坏脚本。在 agent 大量调用 CLI 的时代，这套规范对工具链作者很有参考价值。