SuperAPI AI 工具集

create-cli

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:设计 CLI 的语法与行为界面,输出可实现的紧凑规格,而非直接进入代码实现。

主要能力:产出命令树与 USAGE 概要、参数/标志表(类型、默认值、必填性、示例)、子命令语义、输出规则(stdout 与 stderr、TTY 检测、--json/--plain、--quiet/--verbose)、错误与退出码映射、安全规则(--dry-run、确认、--force、--no-input)、配置与环境变量优先级,以及 5–10 个示例调用。

使用方式:先阅读 agent-scripts/skills/create-cli/references/cli-guidelines.md 并作为默认标准,完整指南见 https://clig.dev/。仅询问锁定界面所需的最少澄清问题(命令名与一句话用途、主要用户、输入来源、输出契约、交互性、配置模型、平台与运行时约束),用户不确定时按最佳猜测默认值推进。

默认约定:-h/--help 始终显示帮助并忽略其它参数;--version 输出到 stdout;主要数据到 stdout,诊断与错误到 stderr;--json 供机器读取,--plain 供稳定行式文本;仅在 stdin 为 TTY 时提示,--no-input 禁用提示;破坏性操作需交互确认,非交互需 --force 或 --confirm=...;尊重 NO_COLOR、TERM=dumb 并提供 --no-color;Ctrl-C 快速退出。配置优先级默认为 flags > env > 项目配置 > 用户配置 > 系统。

限制:仅当用户主动要求时才建议特定语言的解析库,否则保持语言无关;若请求是设计参数,不应转向实现。