Agent Skills
返回列表
CLI参数轻解析

CLI参数轻解析

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/yl20265149 到你的 AI 助手中。

技能介绍

大多数需要命令行的 Node.js 脚本其实只想要几件事:读取 --verbose、--output 这样的开关,拿到对应值,然后将抓到的位置参数拿到手。每周都有那么一两个临时工具只需要这种级别的参数解析,但你不希望为此引入 command 或 yargs 全家桶,因为参数声明、校验和帮助文本会占用脚本一半篇幅。当脚本控制在几百行内,手工解析 process.argv 的噪音会更显眼,于是这个技能带来一个极简方案。

为什么需要这样一个 Skill

在许多日常小脚本中,命令行的典型场景不过就是:

  • 解析几个 --flag,有值或布尔。
  • 相对位置参数也可能想得到。
  • 希望给一些参数配默认值。
  • 需要能把短名字映射到较长的名字。

对这种每天لين都会遇到的场景来说,引入一个超过 50 行的命令行界面方案会显得沉重,而正则手工读 process.argv 又很容易在边界 case 出错。mri 是在社区中广泛使用的微型解析器,速度极佳,API 也很直接,但它需要你手动准备正确的输入、传播默认值与 alias 行为,这些细节正是本技能帮你搞定的。

技能如何工作

首先,在意的是 argv 进解析器的形态。mri 无视分隔符,将参数无差别拆成 names 和 values,只需要提供剔除 node 与脚本名之后的数组,输出会是一个统一对象:unknown 参数带上双横线的会以数组形式出现在 _ 中,带值的 flag 会变成对应 value 属性,无值布尔会直接为 true。alias 也会在输出时归并到完整名字而不是保留短名。

推荐使用流程:

  1. 安装 mri 作为依赖,不增加样板。
  2. 在入口调用 parseArgs(),传入处理好的数组。
  3. 自测几个典型:--verbose、-h 这类组合以及位置参数应正确暴露在 _ 里。

适用边界与注意点

清晰的事情很重要:如果你在做带子命令 serve、build 的交互式复杂命令行,把它交给 citty 更合适;而本技能专注单层 flag 解析,保持轻量和可预测。此外:

  • 依赖固定为 mri:请将其添加到 package.json,而不是重复造轮子。
  • 不做的事很明确:

- 用正则去切 argv,很容易在引号、空值或以 - 开头的位置参数等场景出现误判。
- 用一个极简解析器堆出多级子命令树。
- 生成 help 文本或完整命令树——交给 citty 或专门的工具。

当你只需要几个 --flag,想要 alias、boolean、default 这类基本的解析能力,同时又不愿意引入 yargs/commander 这样的全套命令行框架,那么本技能提供的清晰路径就能既保留脚本小而美,又确保参数处理的可靠性。

使用场景

  • 编写一次性 Node.js 脚本,需要支持 `--verbose` 开关和默认关闭,不想引入 yargs 全家桶。
  • 维护 CI 辅助脚本,希望定义 `--env`、`--force` 布尔和默认值,并正确接收末尾位置参数。
  • 开发小工具时只需要短名映射,例如 `-v` 对应 `verbose`,并让未匹配参数进入 `_`。

适合人员

  • {'zh': '独立工程师:编写一次性 Node.js 脚本,想快速解析 `--verbose` 和位置参数,拒绝重型框架。', 'en': None}
  • {'zh': '运维 / DevOps:维护部署或构建脚本,需要 `--env`、`--force` 的别名、布尔和默认值,同时避免依赖膨胀。', 'en': None}
  • {'zh': '开源工具作者:设计专注 flags 的小型 CLI,希望用最短代码处理短名映射和位置参数。', 'en': None}