SuperAPI AI 工具集

create-cli

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:设计 CLI 的语法与行为,即命令行界面(surface area),兼顾人类使用与脚本调用。

主要能力:先阅读 agent-scripts/skills/create-cli/references/cli-guidelines.md 作为默认准则,上游完整指南见 https://clig.dev/。通过最少澄清问题锁定接口,包括命令名与一句话用途、主要用户(人类/脚本/两者)、输入来源(args 与 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 快速退出。

限制:该技能语言无关,仅在用户要求时推荐解析库;若请求是“设计参数”,不应转向实现。资料未提供具体安装命令、收费或平台支持细节。