SuperAPI AI 工具集

cli-ux-designer

设计与创作

查看项目

更新于 10-16 01:13

技能介绍

用途:该技能在用户要求“设计 CLI”“改进命令结构”“格式化终端输出”“评审 CLI 可用性”“设计帮助页”等场景下使用,充当 CLI 设计顾问,帮助设计、评审和改进命令行工具。不适用于 GUI/Web 界面设计、后端 API 设计、命令行以外的通用 UX 设计以及编程语言设计。

主要能力:以四项核心原则开展设计,包括合理默认值并便于覆盖、保持品牌一致性、降低认知负荷、以终端为先并集成 Web。提供命令结构模式:tool <command> <subcommand> [value] [flags] [value],并区分命令、子命令、标志与值的职责。给出决策框架,如标志用于修改命令运行方式、子命令用于定义动作;交互与非交互的取舍;输出格式在 TTY 与管道下的差异;错误处理与退出码约定(0 成功、1 一般错误、2 用法错误,错误写入 stderr)。同时涵盖视觉设计系统,包括等宽字体排版、8 种基本 ANSI 颜色的含义、Unicode 图标使用,以及列表、详情视图、提示、帮助页等组件模式。帮助页要求包含 Usage、Core commands、Flags、Learn more、Inherited flags 等部分。语法约定包括 <required-args>、[optional-args]、{mutually-exclusive}、repeatable...,多词变量使用 dash-case。

使用方式与限制:作为设计参考与评审依据,输出应遵循其原则与模式;文档中引用的 ./references 下的 ANSI 颜色、Unicode 符号及示例文件属于该技能的参考资源,具体内容未在资料中展开。需注意颜色不应作为唯一含义载体、部分终端对 256 色支持不可靠、Unicode 字体支持因系统而异等限制。

适用场景:为 CLI 工具制定命令层次、标志命名、帮助文本、交互提示与输出规范,评审现有 CLI 的可用性,或排查常见反模式,如深层嵌套子命令、标志命名不一致、无可跳过交互提示、错误信息晦涩、静默失败、子命令缺少 --help、stdout 与状态信息混用等。