Agent Skills
返回列表
轻量命令行框架

轻量命令行框架

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/cf20269912。

技能介绍

要解决的问题

写 Node 脚本时,很多人会手动遍历 process.argv 解析参数,命令一多就乱了;换成 commander 或 yargs,又觉得为一个小工具引入完整框架不值当。这个技能瞄准中间地带:用 cac 声明一个经典小 CLI——有子命令、有选项、能输出 --help,但不需要重型方案的制度化成本。

核心能力与工作方式

整体链路是 cac() → 声明 command/option → parse(),与热门轻量库 cac(Command And Conquer)保持同一套心智模型。

关键步骤:

  1. 声明命令与选项:用 cac() 创建实例,逐条定义 command 与 option,业务逻辑收敛在 action 回调里;
  2. 入口解析:调用 parse(),框架负责拆分 argv 并分发到对应命令;
  3. 自测:运行 node cli.js greet 小四 --loud 验证参数解析,--help 验证帮助输出。

它与 UnJS 的 citty(偏命令体系)、mri(只解析 argv)互补:本技能专注 cac 式声明式 CLI 的组织方式,实现要点会以「小四原创」注释标出,方便区分框架原生用法与作者封装。

适用边界

  • 适合:本地生成、校验、导出的演示性 CLI,需要 --help 与子命令结构的小工具脚本;
  • 不适合:完整交互式向导——这类需求交给 clack;把 cac 硬改成桌面级 TUI 也在禁止之列;
  • 避免复读:若已有 citty 或 mri 的命令架构,本技能不是替代品,只负责 cac 声明式 CLI 这一层。

使用场景

  • 为一个小工具脚本增加子命令和选项解析,不想引入 commander 这类重型库时。
  • 做本地 Demo CLI,需要生成、校验、导出命令和 --help 输出时。
  • 已有 citty 或 mri 的命令结构,只想补充基于 cac 的声明式 CLI 写法时。
  • 需要快速验证 node cli.js greet 小四 --loud 这类参数解析是否正确时。

适合人员

  • 需要为 Node 脚本添加子命令和选项解析,又不想写复杂 argv 遍历的开发者。
  • 想做本地生成、校验、导出命令演示,并希望得到规范 --help 输出的小工具开发者。
  • 已有 citty 或 mri 命令方案,希望补充 cac 声明式 CLI 写法而避免重复封装的作者。
  • 需要在不上重型 CLI 框架的前提下快速搭建和测试命令行入口的工程师。