# 命令行工具该有个「给 AI 看」的输出模式

> 很多 CLI 默认输出冗长杂乱，直接喂给模型很费劲。封装时可用 --agent 或 --minimal 一类开关：去颜色、进度条和交互，用最少字传递更多信息；help 里给足参数示例，让 AI 第一次读 --help 就能多拿上下文。

- 发布于: 2026-03-26
- 原文: https://shanyue.tech/wechat/cli-tools-ai-friendly-output-flag/
- 标签: CLI, 命令行, AI, 工具设计, 开发者体验

---

AI 时代里，不少命令行工具默认并不利于 AI 使用：输出冗长或杂乱，直接给模型用很费劲。

预测在不久的未来，所有的命令行工具都会添加一个参数，使其对 AI 更加友好。

封装时，最好添加某个参数如 --agent 或者 --minimal，用来控制输出格式、给 AI 使用：去掉颜色、进度条、交互式等，用最少的文字给出尽可能多的有效信息。甚至如果无有效信息，可以只打印异常信息和错误。

另外，给每个参数配上足够的示例，让 AI 在第一次看 --help 时就能拿到更多有效信息。

#全栈成长之路