用途:该技能是使用 clap 构建 Rust CLI 应用的实践指南,适用于设计新 CLI、为现有 CLI 添加参数或子命令、校验和解析命令行输入、编写 CLI 集成测试、改进帮助文本与用户体验。
主要能力:包含跨 8 个类别的 42 条规则,按影响从 CRITICAL 到 LOW-MEDIUM 排序。类别与规则前缀:类型驱动设计(type-,CRITICAL)、Derive API 模式(derive-,CRITICAL)、参数配置(arg-,HIGH)、校验与解析(valid-,HIGH)、子命令架构(subcmd-,MEDIUM-HIGH)、帮助与文档(help-,MEDIUM)、错误处理(error-,MEDIUM)、测试模式(test-,LOW-MEDIUM)。
规则示例:用 ValueEnum 处理枚举参数、用 Option 表示可选、用 PathBuf 表示文件路径、用 Vec 表示多值参数、用 newtype 作语义区分;用 derive Parser 作入口、用 Subcommand 派生命令层级、用 Args 复用参数组、用 doc 注释生成帮助、用 Global 传递跨子命令选项;用 default_value 设默认值、env 作环境变量回退、conflicts_with 和 requires 控制选项关系、value_parser 自定义校验;用 assert_cmd、predicates、assert_fs、parse_from、trycmd 做集成与快照测试。
使用方式:资料建议阅读各条规则对应的独立参考文件获取详细说明与代码示例,并列出参考文件:references/_sections.md(类别定义与排序)、assets/templates/_template.md(新增规则模板)、metadata.json(版本与参考信息)。资料未提供具体安装命令或调用命令。
限制:资料仅列出规则名称与类别结构,未展开每条规则的完整代码示例与实现细节;该技能面向使用 clap 的 Rust CLI 场景,不涉及其他语言或参数解析库;具体版本、依赖配置和平台支持暂未提供。