SuperAPI AI 工具集

cli-developer

智能体与模型

查看项目

更新于 10-15 21:40

技能介绍

用途:在构建 CLI 工具、实现参数解析或添加交互式提示时使用,帮助规划命令层级、标志与配置,并完成打磨与测试。

主要能力:按核心工作流推进——分析 UX(先列出所有命令及预期 --help 输出)、设计命令(子命令、标志、参数、配置,保持命名一致且不破坏既有签名)、实现(按语言选用框架)、打磨(补全、帮助文本、错误信息、进度指示,检测 TTY 决定是否着色,优雅处理 SIGINT)、测试(跨平台冒烟测试,启动时间目标 <50ms)。参考指南按主题加载:设计模式、Node.js(commander、yargs、inquirer、chalk)、Python(click、typer、argparse、rich)、Go(cobra、viper、bubbletea)、UX 模式(进度条、颜色、帮助文本)。

使用方式:按语言选择框架实现命令,接线后运行 <cli> --help 验证帮助文本、<cli> --version 确认版本输出。Node.js 示例使用 commander,通过 program.command().option().action() 定义子命令与选项,最后 program.parse()。Python 与 Go 的快速开始见对应参考文件。

约束:必须保持启动时间低于 50ms,提供清晰可操作的错误信息,支持 --help 与 --version,标志命名一致,优雅处理 SIGINT,尽早校验输入,同时支持交互与非交互模式,并在 Windows、macOS、Linux 上测试。不得无谓阻塞于同步 I/O,输出将被管道传递时日志写 stderr,非 TTY 时不着色(Node 用 process.stdout.isTTY,Python 用 sys.stdout.isatty(),Go 用 term.IsTerminal),不得破坏既有命令签名,不得在 CI/CD 中强制交互输入,不得硬编码路径或平台逻辑,不应缺少 shell 补全。

适用场景:需要设计命令结构、配置处理(文件、环境变量、标志)、核心实现与错误处理、shell 补全脚本时。限制:资料未提供具体收费、价格与平台支持细节。