SuperAPI AI 工具集

create-cli

设计与创作

查看项目

更新于 10-15 22:11

技能介绍

用途:当用户要求设计 CLI、设计命令行参数、确定工具应有哪些 flag 或生成 CLI 规范时使用;也可用于审计已有 CLI。

主要能力:先读取 cli-guidelines.md 作为默认 CLI 准则(含 Agent Ergonomics 部分),新设计还会读取 language-selection.md 以给出语言建议。随后区分新设计与审计:新设计会澄清命令名与用途、主要使用者(智能体/人类/脚本/混合)、输入来源、输出契约、后端数据层、交互性、配置模型、语言与分发方式;审计则询问 CLI 名称与源码位置、主要使用者、痛点,并用 Glob/Grep 查找命令定义、flag 注册、输出格式与错误处理,运行 <cli> --help 捕获实际行为。

约定要点:默认人类可读文本,--json/--plain 显式指定数据格式并覆盖 TTY 状态;列表命令在 JSON 模式用 NDJSON;主数据到 stdout,诊断到 stderr;--json 或非 TTY 时抑制 ANSI 与进度动画。面向智能体时,错误以 JSON 对象输出到 stderr,含 error、message、hint;退出码 0 成功、1 运行时错误、2 用法错误,可扩展 3 未找到、4 认证、5 上游、7 冲突。flag 命名跨子命令一致;仅 TTY 时提示,--no-input 禁用提示;破坏性操作需确认,非交互需 --force;尊重 NO_COLOR、TERM=dumb。

交付:审计产出按严重程度(Breaking/Major/Minor)组织的差距报告;新设计产出紧凑规范,含命令树、参数表、子命令语义、输出规则、错误与退出码、安全规则、配置优先级、数据层决策、API 来源、补全方案与示例调用。最后进行验证。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;若语言未确定则省略解析库;请求为“设计参数”时不应转入实现。