SuperAPI AI 工具集

cli

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:本技能面向命令行应用的设计与实现,聚焦程序与终端、Shell、管道之间的接口约定,帮助 CLI 具备可组合性、可脚本化与良好的终端体验。

主要能力:涵盖参数规范(POSIX 短选项与 GNU 长选项、-- 终止符、- 表示标准输入输出、标准旗标命名)、输出流分离(stdout 承载数据、stderr 承载诊断,按流独立检测 TTY)、退出码约定(0 成功、1 错误、2 用法错误,信号码用 128+N)、配置层级(旗标 > 环境变量 > 项目配置 > 用户配置 > 系统配置 > 默认值,遵循 XDG)、交互行为(仅在 stdin 为 TTY 时提示,提供 --no-input、--dry-run、破坏性操作确认)、信号处理(SIGINT/SIGTERM/SIGPIPE 与崩溃恢复)、帮助文本、错误信息、结构化输出(--json、--plain、分页器)以及命名与向后兼容。

使用方式:编写或评审 CLI 代码时应用上述约定;使用参数解析库(如 clap、cobra、argparse、commander);从项目初期就正确接线 stdout/stderr 并处理信号。评审时优先检查 stdout 与 stderr 的使用、退出码与实际成败是否一致、--help/--version/--no-color 是否支持,以及旗标与环境变量中是否泄露密钥。

适用场景:命令行工具开发与代码评审。限制:仅覆盖 CLI 平台层面,语言相关的参数解析库与终端 I/O API 细节由对应语言技能提供;文档未提供具体平台、收费或效果信息。