SuperAPI AI 工具集

create-cli

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:设计 CLI 的语法与行为表面,兼顾人类使用与脚本调用。使用前先阅读 references/cli-guidelines.md 作为默认准则,完整上游准则见 https://clig.dev/。

主要能力:快速澄清最少问题后锁定接口,包括命令名与一句话用途、主要用户(人类/脚本/两者)、输入来源(参数与 stdin、文件与 URL、密钥不通过标志传递)、输出契约(人类文本、--json、--plain、退出码)、交互性(是否允许提示、是否需要 --no-input、破坏性操作确认)、配置模型(标志/环境变量/配置文件及优先级、XDG 与仓库本地)、平台与运行时约束。

交付物:命令树与 USAGE 概要;参数/标志表(类型、默认值、必填/可选、示例);子命令语义;输出规则(stdout 与 stderr、TTY 检测、--json/--plain、--quiet/--verbose);错误与退出码映射;安全规则(--dry-run、确认、--force、--no-input);配置/环境变量规则与优先级(标志 > 环境变量 > 项目配置 > 用户配置 > 系统);Shell 补全方案;5–10 个示例调用。

默认约定:-h/--help 始终显示帮助并忽略其他参数;--version 输出到 stdout;主数据到 stdout,诊断/错误到 stderr;提供 --json 机器输出,考虑 --plain 稳定行文本;仅在 stdin 为 TTY 时提示,--no-input 禁用提示;破坏性操作需交互确认,非交互需 --force 或 --confirm=...;尊重 NO_COLOR、TERM=dumb,提供 --no-color;处理 Ctrl-C 快速退出、有界清理。

限制:该技能语言无关,仅在用户要求时推荐解析库;若请求是“设计参数”,不要转向实现。本技能复制自 steipete/agent-scripts,上游 https://github.com/steipete/agent-scripts,MIT 许可。