用途:在设计、实现或审查命令行工具时激活,尤其当用户提到 --help、flags、子命令、退出码、stdout/stderr、管道、JSON 输出、颜色、提示、配置文件、环境变量、CI 可用性、安装卸载或遥测时。
主要能力:产出 CLI 契约(命令、flags、IO 行为、退出码、配置与环境变量、示例、安全行为);起草帮助输出与文档结构(示例优先);在可运行时用 scripts/cli_audit.py 做合规审计。
不可妥协的 CLI 规范:成功退出码为 0,失败为非零并尽量有含义且文档化;stdout 用于主要输出与机器可读输出,stderr 用于错误、警告、进度与状态消息;--help(通常含 -h)显示帮助并退出,--version 打印版本并退出;仅在 stdin 为 TTY 时提示,提供 --no-input 强制非交互;非 TTY 时不输出 ANSI 颜色与 spinner,支持 NO_COLOR 与 --no-color,考虑 --json 与 --plain 提供稳定输出。
工作流:先按用户任务勾勒 CLI 契约,决定命令形态(单命令或子命令)、输入方式(参数、flags、stdin、提示、配置/环境变量)、输出模式(人类默认加机器模式)、安全措施(确认、--dry-run、--force、密钥处理);使用 CLI 参考与 spec 模板;实现时使用解析库而非手写,明确网络调用、写文件、修改远程状态等跨界操作,避免通过 flags 或环境变量接收密钥、默认打印堆栈、假设 TTY 等陷阱;验证时运行 python scripts/cli_audit.py -- <your-cli> [subcommand],按 stdout/stderr 分离、退出码、帮助可发现性、不安全默认、输出不可脚本化顺序修复。
资源:references/REFERENCE.md、references/CHECKLIST.md、references/EVAL_PROMPTS.md;templates/cli-command-spec-template.json、templates/help-text-template.md、templates/error-message-template.md;scripts/cli_audit.py。
限制:资料未提供具体安装方式、收费、平台支持与效果数据。