用途:create-cli-tool 用于设计或重构 CLI 的接口与行为,以 references/cli-guidelines.md 作为默认评判标准,并在权衡取舍时参考 https://clig.dev/ 的上游指引。它只问锁定接口所需的最少问题,且只向前设计,除非用户要求,否则不保留旧行为。
主要能力:产出紧凑、可直接实现的规格,包括命令树与 USAGE 概要;完整的参数/标志表(类型、默认值、是否必需、示例);子命令的输入、输出、副作用与幂等性;输出规则(stdout 与 stderr、TTY 检测、--json/--plain、--quiet/--verbose);常见失败的错误分类与退出码;安全控制(--dry-run、确认、--force、--no-input);配置与环境变量规则及优先级(flags > env > project config > user config > system);相关时的 shell 补全方案;5-10 个示例调用,含 stdin/管道。
使用方式:先做快速澄清,询问命令名与一句话用途、主要受众(人类、脚本或两者)、输入(flags/args 与 stdin、文件与 URL,密钥绝不通过 flags)、输出(人类文本、结构化 --json 或稳定行文本 --plain)、交互性(是否允许提示、是否需要 --no-input、破坏性操作确认)、配置(flags 与环境变量与配置文件、优先级模型、XDG 与仓库本地)、运行时约束(目标操作系统、单二进制或需运行时);不清楚时使用合理默认值继续。默认规则包括:-h/--help 打印帮助并忽略其他标志;--version 输出到 stdout;主数据到 stdout、诊断到 stderr;提供 --json 供机器输出,必要时加 --plain;仅当 stdin 是 TTY 时才提示,--no-input 禁用提示;破坏性操作需显式确认或 --force;尊重 NO_COLOR 与 TERM=dumb,提供 --no-color;Ctrl-C 快速退出并最少清理。
适用场景与限制:适合定义新 CLI 规格或重塑现有命令面。除非被要求推荐解析库,否则保持语言无关;若请求只涉及参数,则避免实现细节。资料未提供具体收费、平台或效果信息。