用 ag-kit 仓库的 CLI 工具模板搭建健壮的 Node.js 命令行工具Commander.js 与交互式提示的完整实践【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit本篇技术指南以 .agents/skills/app-builder/templates/cli-tool/TEMPLATE.md 为骨架围绕其提供的 Node.js CLI 脚手架规范技术栈、目录结构、设计原则、关键组件与最佳实践逐条展开并全程以本仓库 cli/ 目录下已经落地的ag-kitCLI一个用于安装和安全更新 AI Agent 模板集的真实命令行工具作为源码级佐证。读完后你将掌握从零搭建一个支持子命令、交互式确认、非交互模式、彩色输出与安全文件管理的 CLI 工具并理解如何用测试保证其可维护性。模板是什么一份可复用的 CLI 工程化清单这份TEMPLATE.md不是泛泛的入门教程而是一份工程级脚手架规范。它以 Node.js 24 TypeScript (ESM) 为基线规定了入口薄、命令工厂化、业务逻辑框架无关的分层思想并且明确了各环节的选型Commander.js 负责命令解析inquirer/prompts负责交互式提问chalk 与 ora 负责输出体验cosmiconfig 负责配置发现。值得注意的是模板开头特别注明Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.即模板给出的版本号是验证过的最新稳定线真正脚手架时要以当前稳定版为准。这一点在本仓库中得到了直接印证模板声称 Commander.js v15要求 Node ≥22.12而仓库实际发布的 cli/package.json 使用的是commander^12.1.0并声明engines.node 18。这恰恰说明模板给方向、脚手架时按环境锁定版本的实践。技术栈全景与仓库对照模板给出的技术栈如下组件技术选型运行时Node.js 24Krypton LTS语言TypeScriptESMCLI 框架Commander.jsv15要求 Node ≥22.12交互提示inquirer/prompts模块化输出chalk ora配置cosmiconfig对应地cli/package.json 中的实际依赖可以看作这套技术栈的一次真实落地带差异commander^12.1.0命令解析框架模板所述选型的稳定基线版本chalk^5.6.2彩色输出ora^8.2.0加载动画 / spinnerfs-extra、giget模板未列出的工程化补充——分别用于安全的文件操作与从 Git 模板下载工具包type: module与模板ESM by default的要求完全一致bin: { ag-kit: bin/index.js }对外暴露可执行命令。需要澄清的是模板是一个通用脚手架规范它所列的inquirer/prompts与cosmiconfig是新项目建议选型而仓库中的ag-kitCLI 是这套理念的一个成熟实现在提示环节使用了更轻量的readline封装见 cli/bin/index.js 中的confirm函数在配置环节采用内嵌 manifest 而非外部配置文件。这展示了模板的灵活性原则比具体库更重要。目录结构入口薄、命令工厂、逻辑可测模板要求的目录结构如下project-name/ ├── src/ │ ├── index.ts # Entry: #!/usr/bin/env node shebang, wires Commander │ ├── commands/ # One file per command (factory functions) │ ├── lib/ # Core logic (framework-agnostic, testable) │ ├── utils/ # logger (chalk/ora), prompt wrappers │ └── config.ts # cosmiconfig loader ├── dist/ # Build output (tsup/tsc) └── package.json # type:module, bin:{...}这套结构的三条核心纪律是入口薄index.ts只做两件事——写 shebang、接线 Commander命令工厂化commands/下每个命令一个文件以工厂函数返回Command实例核心逻辑与框架解耦lib/放纯业务逻辑不依赖 Commander因此可以直接单元测试。仓库中的 cli/ 目录虽然因为以 JavaScript 发布而略有差异但结构思想一脉相承bin/index.js—— 对应src/index.ts第一行就是#!/usr/bin/env node见 cli/bin/index.js并通过buildProgram()组装全部命令lib/managed-tree.js—— 对应src/lib/是完全框架无关的核心逻辑manifest 读写、更新计划生成、备份与回滚test/*.test.js—— 对应模板隐含的测试层直接对lib/与buildProgram做单元测试。四条 CLI 设计原则模板用一张表给出了设计原则这是整个模板的灵魂原则描述子命令将相关操作分组选项提供带默认值的 flags交互式需要时使用提示非交互式支持--yes类 flags子命令init/update/rollback/status在 cli/bin/index.js 的buildProgram()中四条命令构成了完整的生命周期命令职责ag-kit init安装.agents已存在时安全合并ag-kit update更新托管文件并保留本地修改ag-kit rollback恢复最新或指定备份ag-kit status展示安装、manifest、工具包版本、备份与 CLI 状态仓库的 cli/test/index.test.js 用测试锁定了这组命令的存在与关键选项例如断言update必须带--strategy与--dry-run选项——这是选项与默认值原则的硬性保证。交互式与非交互式--force/--quiet的联动模板强调Interactive when needed, non-interactive with --yes flags。在ag-kitCLI 中交互确认由confirm()实现而requireConfirmation()cli/bin/index.js实现了完整的决策矩阵--dry-run或--force跳过确认直接执行已存在安装且使用--quiet必须同时提供--force否则报错Existing installation requires --force when --quiet is usedCLI 无法在静默模式下安全提问默认交互根据策略给出不同问题replace策略明确提示将备份后再整体替换。这是非交互支持原则在安全场景下的严谨落地宁可报错也不在无人值守时静默覆盖用户文件。关键组件逐个拆解模板给出的五个关键组件及其用途组件用途Commander命令解析为可测试性使用局部new Command()inquirer/prompts模块化交互提示input、select、confirmChalk彩色输出OraSpinner / 加载状态Cosmiconfig配置文件发现Commander局部new Command()的可测试性模板特别强调use a localnew Command()for testability。这是因为如果把命令挂在全局program上测试时会互相污染而用工厂函数buildProgram()每次创建独立实例测试就能直接断言命令与选项。仓库 cli/test/index.test.js 正是这么做的buildProgram()后遍历program.commands断言命令名集合。输出体验chalk ora 的配合ag-kitCLI 展示了教科书式的用法ora({ text: Preparing..., color: cyan }).start()开启加载动画并在下载、安装、更新各阶段动态更新spinner.textcli/bin/index.js成功时spinner.succeed(chalk.green(Installation successful!))有冲突时spinner.warn(chalk.yellow(...))printPlan()用不同颜色区分统计项变更数绿色、保留数黄色、冲突数红色、无变化灰色cli/bin/index.js。交互提示从模板选型到轻量实现模板建议inquirer/prompts的input/select/confirm。仓库实现则基于 Node 内置readline封装了一个confirm(question)输出? 问题 (y/N)归一化回答后只接受y/yescli/bin/index.js。两种方案都满足需要时才交互的原则——脚手架新项目时直接采用inquirer/prompts即可获得更丰富的控件。Cosmiconfig配置发现机制模板要求用 cosmiconfig 提供配置发现。虽然ag-kitCLI 通过.agents/.ag-kit/manifest.json保存运行状态而非读取外部配置但 manifest 的设计体现了同样的思路在约定位置查找可扩展的配置/状态文件并且对文件内容做严格校验schemaVersion、文件路径安全性、SHA-256 格式见 cli/lib/managed-tree.js。从零搭建六步设置流程模板给出的设置步骤这里补充每一步的细节与仓库佐证创建项目目录mkdir project-name cd project-name初始化并声明 ESMnpm init -y然后在package.json中设置type: module—— 仓库 cli/package.json 即为实例安装依赖npm install commander inquirer/prompts chalk ora cosmiconfig再按需补充模板未列但工程需要的包如仓库中的fs-extra、giget接线 bin 与 shebang把package.json的bin指向编译产物./dist/index.js仓库发布的是直接运行的bin/index.js并保证入口文件第一行为#!/usr/bin/env node本地联调npm link把命令软链到全局即可在任意项目里直接敲命令名测试跑通测试仓库用 Node 内置测试器node --test test/*.test.js见 cli/package.json零额外依赖即可开始。发布流程模板给出的发布命令极简npm login npm publish结合 cli/package.json 的files字段bin、lib可以看到发布前应确保只发布运行所需的最小文件集避免把源码、测试、文档一起打进包。仓库的 cli/test/release-safety.test.js 甚至把这条写成了自动化测试断言发布的包必须包含运行时依赖的bin与lib。发布安全与版本一致性模板之外的工程化加分项这是仓库对模板的最佳实践层做出的重要扩展。在 cli/test/release-safety.test.js 中有三条值得借鉴的发布防线GitHub Actions 固定不可变 commit SHA所有 workflow 的uses:必须指向 40 位 commit SHA禁止可变 tagL13-L30发布工作流安全不出现NODE_TLS_REJECT_UNAUTHORIZED禁用 TLS 的写法不出现长期有效的 npm token改用id-token: write的 Trusted PublishingL32-L40版本全局对齐根包、CLI 包、Web 包、所有 lockfile 以及.agents/VERSION的版本号必须一致L42-L61配合 manifest 的toolkitVersion字段保证CLI 版本 工具包版本 文档清单三者可追溯。仓库实例深挖ag-kit如何把模板推向生产级ag-kitCLI 最有价值的部分是把模板业务逻辑放入lib/的原则发挥到极致——cli/lib/managed-tree.js 是一个完全独立于 Commander 的受管文件树引擎值得单独拆解。SHA-256 manifest更新的事实基础每次安装/更新后CLI 都会计算工具包内每个文件的 SHA-256 哈希并写入.agents/.ag-kit/manifest.jsonschemaVersion、toolkitVersion、installedAt、updatedAt、lastRunId、files哈希表。loadManifest()在读取时会拒绝任何含..段、绝对路径或非 64 位十六进制哈希的条目cli/lib/managed-tree.js——cli/test/managed-tree.test.js中malformed manifest paths are rejected用例L173-L186专门验证了路径穿越攻击被拦截。三分法更新计划clean / local / conflictcreateUpdatePlan()cli/lib/managed-tree.js对每个文件比对三个快照——本地当前、上游新版本、manifest 中的历史基线从而把每个文件归类为四类动作之一情形结论本地未改、上游变了update自动应用本地改了、上游未动preserved保留本地本地与上游都改了conflict写入.agents/.ag-kit/conflicts/runId/file.incoming上游已删除、本地未动delete并清理空目录merge是默认策略replace需要显式指定且即使替换也默认创建备份除非显式--no-backup。整个行为被 cli/test/managed-tree.test.js 的集成测试完整覆盖a.txt被更新、b.txt保留本地、user-notes.md用户文件不受影响、obsolete.txt被删除。备份与回滚可撤销的最后防线createBackup()把整个.agents复制到.ag-kit-backups/runId/并附backup.json元数据restoreBackup()回滚前还会先对当前状态做一次pre-rollback-前缀的安全备份形成回滚也可回滚的双保险cli/lib/managed-tree.js、L439-L473。命令与退出码约定ag-kit的退出码设计见 cli/README.md可以作为模板退出码规范的直接参考码含义0成功或无需变更1下载、校验、文件系统或配置失败2更新完成但存在冲突需人工处理130用户中断SIGINT见 cli/bin/index.js在 CI 场景中exit code 2让流水线能区分完全成功与需人工介入两种结果。最佳实践清单模板原文 仓库落实保持src/index.ts薄通过commands/下的工厂函数用.addCommand()挂载 —— 仓库中buildProgram()每次新建Command实例并返回既薄又可测业务逻辑放进lib//utils/让命令只是可测试的薄包装 ——managed-tree.js不 import 任何 CLI 框架任何测试框架都能直接驱动默认 ESM用 tsup/esbuild 构建—— 仓库直接以 ESM 发布并设type: module同时支持交互与非交互--yes模式—— 通过--force/--quiet/--dry-run组合实现用 Zod 校验输入用正确的退出码收尾0 成功、1 错误—— 仓库以choices([merge,replace])做参数枚举校验并落实了 0/1/2/130 四档退出码值得了解的替代方案clack/prompts提示更精美、citty轻量级 ESM 命令框架——模板保留了选型自由度脚手架时可按需替换。上手建议把这份模板用起来直接读模板.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md 本身就是一份自带 frontmattername: cli-tool、description的可消费技能文档适合作为 app-builder 的生成输入对照成熟实现通读 cli/bin/index.js 与 cli/lib/managed-tree.js把命令层 / 逻辑层的边界画出来用测试固化行为参考 cli/test/ 的三个测试文件从命令暴露到更新计划正确性再到发布安全分层补齐测试按需替换组件交互提示可换成inquirer/prompts或clack/prompts配置发现可引入cosmiconfig构建产物可用 tsup——模板的原则不变具体实现随项目环境锁定版本。模板给的是骨架与方向而 cli/ 目录证明了这个骨架足以支撑一个带安全合并、备份回滚、退出码约定和发布自动化测试的生产级 CLI。照此搭建你的下一个 Node.js 命令行工具就能同时拥有清晰的架构、友好的交互和可靠的生命周期管理。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 ag-kit 仓库的 CLI 工具模板搭建健壮的 Node.js 命令行工具：Commander.js 与交互式提示的完整实践
用 ag-kit 仓库的 CLI 工具模板搭建健壮的 Node.js 命令行工具Commander.js 与交互式提示的完整实践【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit本篇技术指南以 .agents/skills/app-builder/templates/cli-tool/TEMPLATE.md 为骨架围绕其提供的 Node.js CLI 脚手架规范技术栈、目录结构、设计原则、关键组件与最佳实践逐条展开并全程以本仓库 cli/ 目录下已经落地的ag-kitCLI一个用于安装和安全更新 AI Agent 模板集的真实命令行工具作为源码级佐证。读完后你将掌握从零搭建一个支持子命令、交互式确认、非交互模式、彩色输出与安全文件管理的 CLI 工具并理解如何用测试保证其可维护性。模板是什么一份可复用的 CLI 工程化清单这份TEMPLATE.md不是泛泛的入门教程而是一份工程级脚手架规范。它以 Node.js 24 TypeScript (ESM) 为基线规定了入口薄、命令工厂化、业务逻辑框架无关的分层思想并且明确了各环节的选型Commander.js 负责命令解析inquirer/prompts负责交互式提问chalk 与 ora 负责输出体验cosmiconfig 负责配置发现。值得注意的是模板开头特别注明Versions reflect the latest stable line verified 2026-05. Pin to the current stable when scaffolding.即模板给出的版本号是验证过的最新稳定线真正脚手架时要以当前稳定版为准。这一点在本仓库中得到了直接印证模板声称 Commander.js v15要求 Node ≥22.12而仓库实际发布的 cli/package.json 使用的是commander^12.1.0并声明engines.node 18。这恰恰说明模板给方向、脚手架时按环境锁定版本的实践。技术栈全景与仓库对照模板给出的技术栈如下组件技术选型运行时Node.js 24Krypton LTS语言TypeScriptESMCLI 框架Commander.jsv15要求 Node ≥22.12交互提示inquirer/prompts模块化输出chalk ora配置cosmiconfig对应地cli/package.json 中的实际依赖可以看作这套技术栈的一次真实落地带差异commander^12.1.0命令解析框架模板所述选型的稳定基线版本chalk^5.6.2彩色输出ora^8.2.0加载动画 / spinnerfs-extra、giget模板未列出的工程化补充——分别用于安全的文件操作与从 Git 模板下载工具包type: module与模板ESM by default的要求完全一致bin: { ag-kit: bin/index.js }对外暴露可执行命令。需要澄清的是模板是一个通用脚手架规范它所列的inquirer/prompts与cosmiconfig是新项目建议选型而仓库中的ag-kitCLI 是这套理念的一个成熟实现在提示环节使用了更轻量的readline封装见 cli/bin/index.js 中的confirm函数在配置环节采用内嵌 manifest 而非外部配置文件。这展示了模板的灵活性原则比具体库更重要。目录结构入口薄、命令工厂、逻辑可测模板要求的目录结构如下project-name/ ├── src/ │ ├── index.ts # Entry: #!/usr/bin/env node shebang, wires Commander │ ├── commands/ # One file per command (factory functions) │ ├── lib/ # Core logic (framework-agnostic, testable) │ ├── utils/ # logger (chalk/ora), prompt wrappers │ └── config.ts # cosmiconfig loader ├── dist/ # Build output (tsup/tsc) └── package.json # type:module, bin:{...}这套结构的三条核心纪律是入口薄index.ts只做两件事——写 shebang、接线 Commander命令工厂化commands/下每个命令一个文件以工厂函数返回Command实例核心逻辑与框架解耦lib/放纯业务逻辑不依赖 Commander因此可以直接单元测试。仓库中的 cli/ 目录虽然因为以 JavaScript 发布而略有差异但结构思想一脉相承bin/index.js—— 对应src/index.ts第一行就是#!/usr/bin/env node见 cli/bin/index.js并通过buildProgram()组装全部命令lib/managed-tree.js—— 对应src/lib/是完全框架无关的核心逻辑manifest 读写、更新计划生成、备份与回滚test/*.test.js—— 对应模板隐含的测试层直接对lib/与buildProgram做单元测试。四条 CLI 设计原则模板用一张表给出了设计原则这是整个模板的灵魂原则描述子命令将相关操作分组选项提供带默认值的 flags交互式需要时使用提示非交互式支持--yes类 flags子命令init/update/rollback/status在 cli/bin/index.js 的buildProgram()中四条命令构成了完整的生命周期命令职责ag-kit init安装.agents已存在时安全合并ag-kit update更新托管文件并保留本地修改ag-kit rollback恢复最新或指定备份ag-kit status展示安装、manifest、工具包版本、备份与 CLI 状态仓库的 cli/test/index.test.js 用测试锁定了这组命令的存在与关键选项例如断言update必须带--strategy与--dry-run选项——这是选项与默认值原则的硬性保证。交互式与非交互式--force/--quiet的联动模板强调Interactive when needed, non-interactive with --yes flags。在ag-kitCLI 中交互确认由confirm()实现而requireConfirmation()cli/bin/index.js实现了完整的决策矩阵--dry-run或--force跳过确认直接执行已存在安装且使用--quiet必须同时提供--force否则报错Existing installation requires --force when --quiet is usedCLI 无法在静默模式下安全提问默认交互根据策略给出不同问题replace策略明确提示将备份后再整体替换。这是非交互支持原则在安全场景下的严谨落地宁可报错也不在无人值守时静默覆盖用户文件。关键组件逐个拆解模板给出的五个关键组件及其用途组件用途Commander命令解析为可测试性使用局部new Command()inquirer/prompts模块化交互提示input、select、confirmChalk彩色输出OraSpinner / 加载状态Cosmiconfig配置文件发现Commander局部new Command()的可测试性模板特别强调use a localnew Command()for testability。这是因为如果把命令挂在全局program上测试时会互相污染而用工厂函数buildProgram()每次创建独立实例测试就能直接断言命令与选项。仓库 cli/test/index.test.js 正是这么做的buildProgram()后遍历program.commands断言命令名集合。输出体验chalk ora 的配合ag-kitCLI 展示了教科书式的用法ora({ text: Preparing..., color: cyan }).start()开启加载动画并在下载、安装、更新各阶段动态更新spinner.textcli/bin/index.js成功时spinner.succeed(chalk.green(Installation successful!))有冲突时spinner.warn(chalk.yellow(...))printPlan()用不同颜色区分统计项变更数绿色、保留数黄色、冲突数红色、无变化灰色cli/bin/index.js。交互提示从模板选型到轻量实现模板建议inquirer/prompts的input/select/confirm。仓库实现则基于 Node 内置readline封装了一个confirm(question)输出? 问题 (y/N)归一化回答后只接受y/yescli/bin/index.js。两种方案都满足需要时才交互的原则——脚手架新项目时直接采用inquirer/prompts即可获得更丰富的控件。Cosmiconfig配置发现机制模板要求用 cosmiconfig 提供配置发现。虽然ag-kitCLI 通过.agents/.ag-kit/manifest.json保存运行状态而非读取外部配置但 manifest 的设计体现了同样的思路在约定位置查找可扩展的配置/状态文件并且对文件内容做严格校验schemaVersion、文件路径安全性、SHA-256 格式见 cli/lib/managed-tree.js。从零搭建六步设置流程模板给出的设置步骤这里补充每一步的细节与仓库佐证创建项目目录mkdir project-name cd project-name初始化并声明 ESMnpm init -y然后在package.json中设置type: module—— 仓库 cli/package.json 即为实例安装依赖npm install commander inquirer/prompts chalk ora cosmiconfig再按需补充模板未列但工程需要的包如仓库中的fs-extra、giget接线 bin 与 shebang把package.json的bin指向编译产物./dist/index.js仓库发布的是直接运行的bin/index.js并保证入口文件第一行为#!/usr/bin/env node本地联调npm link把命令软链到全局即可在任意项目里直接敲命令名测试跑通测试仓库用 Node 内置测试器node --test test/*.test.js见 cli/package.json零额外依赖即可开始。发布流程模板给出的发布命令极简npm login npm publish结合 cli/package.json 的files字段bin、lib可以看到发布前应确保只发布运行所需的最小文件集避免把源码、测试、文档一起打进包。仓库的 cli/test/release-safety.test.js 甚至把这条写成了自动化测试断言发布的包必须包含运行时依赖的bin与lib。发布安全与版本一致性模板之外的工程化加分项这是仓库对模板的最佳实践层做出的重要扩展。在 cli/test/release-safety.test.js 中有三条值得借鉴的发布防线GitHub Actions 固定不可变 commit SHA所有 workflow 的uses:必须指向 40 位 commit SHA禁止可变 tagL13-L30发布工作流安全不出现NODE_TLS_REJECT_UNAUTHORIZED禁用 TLS 的写法不出现长期有效的 npm token改用id-token: write的 Trusted PublishingL32-L40版本全局对齐根包、CLI 包、Web 包、所有 lockfile 以及.agents/VERSION的版本号必须一致L42-L61配合 manifest 的toolkitVersion字段保证CLI 版本 工具包版本 文档清单三者可追溯。仓库实例深挖ag-kit如何把模板推向生产级ag-kitCLI 最有价值的部分是把模板业务逻辑放入lib/的原则发挥到极致——cli/lib/managed-tree.js 是一个完全独立于 Commander 的受管文件树引擎值得单独拆解。SHA-256 manifest更新的事实基础每次安装/更新后CLI 都会计算工具包内每个文件的 SHA-256 哈希并写入.agents/.ag-kit/manifest.jsonschemaVersion、toolkitVersion、installedAt、updatedAt、lastRunId、files哈希表。loadManifest()在读取时会拒绝任何含..段、绝对路径或非 64 位十六进制哈希的条目cli/lib/managed-tree.js——cli/test/managed-tree.test.js中malformed manifest paths are rejected用例L173-L186专门验证了路径穿越攻击被拦截。三分法更新计划clean / local / conflictcreateUpdatePlan()cli/lib/managed-tree.js对每个文件比对三个快照——本地当前、上游新版本、manifest 中的历史基线从而把每个文件归类为四类动作之一情形结论本地未改、上游变了update自动应用本地改了、上游未动preserved保留本地本地与上游都改了conflict写入.agents/.ag-kit/conflicts/runId/file.incoming上游已删除、本地未动delete并清理空目录merge是默认策略replace需要显式指定且即使替换也默认创建备份除非显式--no-backup。整个行为被 cli/test/managed-tree.test.js 的集成测试完整覆盖a.txt被更新、b.txt保留本地、user-notes.md用户文件不受影响、obsolete.txt被删除。备份与回滚可撤销的最后防线createBackup()把整个.agents复制到.ag-kit-backups/runId/并附backup.json元数据restoreBackup()回滚前还会先对当前状态做一次pre-rollback-前缀的安全备份形成回滚也可回滚的双保险cli/lib/managed-tree.js、L439-L473。命令与退出码约定ag-kit的退出码设计见 cli/README.md可以作为模板退出码规范的直接参考码含义0成功或无需变更1下载、校验、文件系统或配置失败2更新完成但存在冲突需人工处理130用户中断SIGINT见 cli/bin/index.js在 CI 场景中exit code 2让流水线能区分完全成功与需人工介入两种结果。最佳实践清单模板原文 仓库落实保持src/index.ts薄通过commands/下的工厂函数用.addCommand()挂载 —— 仓库中buildProgram()每次新建Command实例并返回既薄又可测业务逻辑放进lib//utils/让命令只是可测试的薄包装 ——managed-tree.js不 import 任何 CLI 框架任何测试框架都能直接驱动默认 ESM用 tsup/esbuild 构建—— 仓库直接以 ESM 发布并设type: module同时支持交互与非交互--yes模式—— 通过--force/--quiet/--dry-run组合实现用 Zod 校验输入用正确的退出码收尾0 成功、1 错误—— 仓库以choices([merge,replace])做参数枚举校验并落实了 0/1/2/130 四档退出码值得了解的替代方案clack/prompts提示更精美、citty轻量级 ESM 命令框架——模板保留了选型自由度脚手架时可按需替换。上手建议把这份模板用起来直接读模板.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md 本身就是一份自带 frontmattername: cli-tool、description的可消费技能文档适合作为 app-builder 的生成输入对照成熟实现通读 cli/bin/index.js 与 cli/lib/managed-tree.js把命令层 / 逻辑层的边界画出来用测试固化行为参考 cli/test/ 的三个测试文件从命令暴露到更新计划正确性再到发布安全分层补齐测试按需替换组件交互提示可换成inquirer/prompts或clack/prompts配置发现可引入cosmiconfig构建产物可用 tsup——模板的原则不变具体实现随项目环境锁定版本。模板给的是骨架与方向而 cli/ 目录证明了这个骨架足以支撑一个带安全合并、备份回滚、退出码约定和发布自动化测试的生产级 CLI。照此搭建你的下一个 Node.js 命令行工具就能同时拥有清晰的架构、友好的交互和可靠的生命周期管理。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考