CLI参数轻解析
将以下提示词粘贴到你的 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 也会在输出时归并到完整名字而不是保留短名。
推荐使用流程:
- 安装
mri作为依赖,不增加样板。 - 在入口调用
parseArgs(),传入处理好的数组。 - 自测几个典型:
--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}