SuperAPI AI 工具集

rust-cli

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:把命令行界面当作稳定的用户协议来对待,而不是把业务逻辑直接写进 main,完成从契约确认到实现、真实进程验证的端到端闭环。

主要能力:先确认需求与既有帮助文本、脚本、README、测试、发布配置,明确命令名、子命令、参数、默认值、互斥与兼容要求,区分人类输出与机器输出、输入优先级、成功与各类错误对应的退出码、平台与 shell、TTY/管道环境、MSRV、依赖版本,以及配置文件>环境变量>命令行选项的优先级。若关键契约缺失,从既有行为与测试推断最小兼容方案并显式说明假设,不随意改动标志、输出文本或退出码。

使用方式:建立行为基线(rustc --version --verbose、cargo metadata --no-deps --format-version 1、cargo test --all-targets、cargo run -- --help),记录至少一次成功与一次失败调用及其 stdout、stderr、退出码;先写行为矩阵再实现解析;把入口保持轻薄,流程为处理参数与环境→解析为 Options/Command→调用可测试的 run(command, io, context)→把领域结果映射为输出与 ExitCode;用 BufRead、Write 注入 I/O 适配器,正常结果写 stdout、诊断写 stderr,仅在检测到 TTY 后启用交互提示;错误信息简短可操作,按类别映射稳定退出码,正确处理 broken pipe,用户输入、文件、网络、配置失败不使用 unwrap()/expect();用真实进程覆盖 --help/--version、成功路径、未知参数、流分离、退出码、stdin 管道与配置优先级;通过 fmt、check、test、clippy、build --release 门禁。

适用场景:命令与子命令、配置文件与环境变量优先级、机器可读输出、跨平台 CLI、含守护进程、IPC、PTY、TUI 的终端应用。

限制:支持的平台与发布产物需有证据,未验证部分要显式标注;测试分层、覆盖率、模糊测试与基准交由 rust-testing,Cargo 特性、工作区、交叉编译与打包发布交由 rust-cargo-build,所有权与 I/O trait 或错误类型交由 rust-stable,异步任务与信号交由 rust-concurrency,HTTP 服务交由 rust-web。资料未提供具体收费、价格或平台信息。