用途:该技能用于在实现前或重构阶段指导命令行接口(CLI)设计,产出紧凑、可落地的规范,重点关注人类友好性与脚本兼容性,遵循 clig.dev 等既有约定。
主要能力:
- 澄清环节:了解命令用途、使用者(人类、自动化脚本或两者)、单命令或含子命令的套件;输入契约(参数、stdin、文件、交互提示,必填与可选,是否支持批量操作);输出契约(人类可读文本、JSON、结构化数据,stdout 与 stderr 划分,是否多格式);交互性(是否适合交互提示、非交互模式、管道或 CI 环境下的行为);配置项(标志、环境变量、配置文件)与优先级、默认值。
- 交付物规范:命令树与用法、参数与标志表(名称、类型、是否必填、默认值、说明)、各子命令细节(用途、行为、必填与可选参数、专属标志、状态变更或副作用、退出码)、输出规则(stdout 放主要输出与机器可解析数据,stderr 放错误、警告、进度与诊断信息)、退出码(0 成功、1 一般错误、2 用法错误、3 配置错误、4 运行时错误、130 中断)、安全机制(--dry-run 预览、交互确认、--force 跳过确认)、配置优先级(命令行标志 > 环境变量 > 配置文件 > 内置默认)以及 5 至 10 个使用示例。
默认约定:标准标志如 -h/--help、--version、-v/--verbose、--no-color(遵循 NO_COLOR)、--quiet/-q、--force/-f、--dry-run;终端行为遵循 NO_COLOR 与 TERM=dumb,检测 TTY 与管道;交互提示仅在 TTY 下出现,非交互模式需 --no-input 或 --force 并以安全选项为默认;破坏性操作须确认并提供 --force;错误写入 stderr,使用具体退出码与可操作提示。
使用方式:在用户要求设计 CLI、创建命令行界面、设计 CLI 参数或规划 CLI 用户体验时触发;先澄清再按结构输出规范。
适用场景:从零设计新命令行工具、重构现有 CLI 改善体验、规划参数与子命令、定义帮助与错误文本、建立配置与环境变量处理、设计安全操作模式。
限制:该技能与语言无关,除非用户要求特定解析库建议;聚焦接口设计而非实现代码;资料未提供具体收费、平台或效果信息。