用途：设计 CLI 的语法与行为，输出可直接实现的紧凑规格，而非实现代码。
主要能力：梳理命令树与 USAGE 概要；定义参数/标志表（类型、默认值、必填性、示例）；说明子命令语义、幂等性与状态变化；规定输出规则（stdout 与 stderr 分离、TTY 检测、--json/--plain、--quiet/--verbose）；给出错误与退出码映射；安全规则（--dry-run、确认、--force、--no-input）；配置与环境变量优先级（flags > env > 项目配置 > 用户配置 > 系统）；shell 补全方案；5–10 个示例调用。
默认约定：-h/--help 始终显示帮助并忽略其他参数；--version 输出到 stdout；主数据走 stdout，诊断与错误走 stderr；提供 --json 机器输出，考虑 --plain 稳定文本；仅在 stdin 为 TTY 时提示，--no-input 禁用提示；破坏性操作需交互确认，非交互需 --force 或 --confirm=...；尊重 NO_COLOR、TERM=dumb，提供 --no-color；处理 Ctrl-C 快速退出、有限清理。
使用方式：先阅读 references/cli-guidelines.md 作为默认准则，上游完整指南见 https://clig.dev/；仅询问锁定接口所需的最少澄清问题，用户不确定时按最佳猜测默认值继续。
适用场景：需要设计或评审 CLI 参数、交互与输出契约时。
限制：若请求是“设计参数”，不要转向实现；仅在用户要求时推荐特定语言的解析库，否则保持语言无关。具体平台/运行时约束、配置路径等需用户提供，资料未提供则暂未提供。