用途:为编写符合 UNIX 哲学与 POSIX 约定的命令行工具提供规范指引,适合 AI 智能体与 LLM 在编写任何语言的新 CLI 工具、解析参数与标志、决定 stdout 与 stderr 分工、选择退出码、处理 SIGINT/SIGTERM 等信号时参照。
主要能力:共 44 条规则,分 8 类并标注影响优先级。关键级包括参数与标志设计(使用标准解析库、为短选项提供长选项、支持双横线终止选项、实现 --help 与 --version、优先标志而非位置参数、使用标准标志名、不从命令行标志读取密钥、支持选项捆绑)、退出码(仅成功返回零、使用标准退出码、信号终止用 128+N、一致处理部分成功、区分错误类型)、输出流(数据仅写 stdout、错误与诊断写 stderr、检测 TTY、提供机器可读格式、基于行的文本输出、遵守 NO_COLOR)。高优先级涵盖错误处理(含程序名、可操作信息、使用 strerror、避免堆栈回溯、尽早校验失败)与 I/O 组合(支持 stdin、默认写 stdout、无状态设计、安全处理二进制、原子写入、多文件一致处理)。中高优先级为帮助与文档(参数错误显示用法、结构化帮助、显示默认值、含实用示例、版本格式)。中优先级为信号与健壮性(优雅处理 SIGINT、SIGTERM 干净关闭、SIGPIPE 处理、二次中断跳过清理)与配置环境(遵循 XDG 基础目录规范、正确优先级顺序、一致环境变量命名、不存密钥、尊重标准环境变量)。
使用方式:按需查阅各参考文件获取详细说明与代码示例,包括 sections 定义、规则模板;参考文件含 references/_sections.md、assets/templates/_template.md、metadata.json(版本与参考信息)。
限制:资料未提供具体安装命令、价格、平台、实际效果或完整代码示例,上述内容暂未提供;规则采用前缀命名以便分类检索。