Agent Skills
返回列表
💻

用 zx 编写可靠命令行脚本指南

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-zx-scripting-guide。

技能介绍

要解决什么问题

用 zx 写命令行脚本时,常见问题不是「会不会调 API」,而是:错误处理不完整、子进程与路径假设写死在代码里、在 CI 里偶发失败却难以复现。团队里还常见:脚本 PR 没人按统一标准评审,交接时只有几段 mjs 没有设计说明,线上告警来了只能凭感觉改。

本技能把工程化做法落到「zx 脚本」这一具体载体上:在你给出 diff、报错栈、需求约束或选型场景时,产出可执行的检查清单、方案骨架和排错路径,而不是泛泛的 JavaScript 教程。

技能如何工作

技能通过触发词路由进入六类能力,可单独使用也可组合:

  • 代码评审:针对 zx 相关 PR/diff,按正确性(进程退出码、超时、并发)、安全(命令注入、秘钥落盘)、可维护性(可测试性、重复逻辑)给出 阻断 / 建议 / 可选 分级意见。
  • 技术方案设计:在「自动化发布、批处理任务、胶水脚本替代 Bash」等需求下,输出含背景、目标、选型与风险的方案模板。
  • 调试排错:根据报错与运行上下文,整理复现步骤 → 隔离变量(Node 版本、cwd、环境变量)→ 证据(stderr、退出码)→ 修复验证的定位树。
  • 架构权衡:在 zx、纯 Bash、child_process 封装等选项间做利弊与适用规模对比。
  • API 设计 / 工程规范:为脚本对外调用的接口契约、命名与反模式清单提供结构化草稿(仍由你落地到仓库)。

工作流上强调两条主线:先读懂改动意图再谈风格的评审顺序,以及先稳定复现再改代码的线上排错纪律;输出物可直接套用 SKILL 中的方案模板与评审清单示例。

适用边界

  • 只提供方法论、模板与检查清单,不代你执行命令、不接入付费服务、不处理真实密钥(仅脱敏示例)。
  • 评审与方案结论是辅助参考,合并与上线决策仍由负责人承担。
  • 不涉及 zx 安装选型之外的「替你做架构拍板」;复杂合规或安全审计仍需专业流程。

使用场景

  • Review 一份把多条 shell 流水线迁到 zx 的 PR,需要按退出码与子进程错误分级标出阻断项
  • 新需求要用 zx 在 CI 里批量改配置并回调内部 API,要先写清选型理由与回滚方案
  • 本机可跑、CI 里 zx 脚本报 `ENOENT` 或静默失败,需要复现步骤和环境变量隔离清单
  • 在 zx、Makefile 与手写 Bash 之间选型,要对比维护成本、可测试性与团队现有栈

适合人员

  • 维护发布流水线的 DevOps,希望 zx 脚本 PR 有统一评审清单而不是只看风格
  • 全栈工程师接手遗留 zx 工具,需要把「为什么这样写」补成可交接的方案与风险说明
  • On-call 后端在告警后排查 zx 包装的外部命令失败,需要结构化复现而非直接改脚本试运气
  • 技术负责人要在小团队内推广 zx 替代脆弱 Bash,需要选型表与工程反模式清单说服评审