用途:platform-cli 是面向命令行工具设计与实现的模式集合,用于在设计 CLI、评审 CLI 用户体验、定义命令与标志时提供可操作的规则与参考。
主要能力:规则部分按主题拆分为离散条目,包括命令与命名(小写、易输入的命令名)、标志与参数(-h、-v、-q 等标准约定)、配置(优先级为 flags > env > config > defaults)、输出与流(stdout 与 stderr 分离)、错误处理(可操作、给出明确修复方式的错误信息)、信号与生命周期(Ctrl-C 处理,带超时与强制选项)、安全(不从环境变量读取密钥)、分发(尽可能打包为单一二进制)。
参考文档:references/cli-patterns.md 提供更全面的指引,按设计与命名、标志与参数、输出与格式化(TTY 检测、颜色、机器可读格式)、错误处理(退出码、信噪比)、信号与生命周期、环境与配置、分发与打包、安全与隐私(密钥处理、遥测同意)组织。
使用方式:当请求明确匹配其范围时应用该技能规则与引用指引,产出具体结果;再依据约束校验输出质量,若仍有缺口,可在明确假设后细化一次。触发示例:为部署工具设计 CLI 命令、标志与退出码。非触发示例:编写 PostgreSQL 分区迁移计划。
限制与排障:若技能未按预期触发,通常是请求措辞未清晰匹配描述中的触发条件,可改用描述中的领域或任务关键词重述后重试;若多个技能指引冲突,需说明当前步骤以哪个技能为准并优先应用其工作流;若输出过于笼统,通常是输入缺少上下文、约束或目标格式,可补充环境、范围、格式与成功标准后重跑。具体安装命令、收费与平台支持信息暂未提供。