Agent Skills
返回列表
💻

Bash 防御式编程模式

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/rmyndharis-antigravity-skills-bash-defensive-patterns。

技能介绍

问题从哪来

把 Bash 脚本直接推到生产或 CI/CD 里,常见结局是:未加引号的变量在空格路径上裂片、缺少 set -euo pipefail 导致某步失败后继续脏写、临时文件与 rm -rf ${var} 类误伤、以及线上几乎无法定位的静默失败。POSIX sh 规范与日常 Bash 特性混用,也会让同一脚本在不同发行版上表现不一致。

技能怎么帮上忙

本技能按防御式 Shell 编程组织工作流:先确认目标 shell、操作系统与执行环境,再从开头启用严格模式与安全默认;对入参做校验、始终引用变量、按安全方式读写文件;配套日志、ERR 陷阱与基础自检(可对照 resources/implementation-playbook.md 里的模式、清单与模板)。

适用典型产出包括:

  • 生产级自动化与批处理脚本
  • CI/CD 流水线中的 shell 步骤
  • 需跨平台运行的运维/部署工具
  • 带可观测性的错误恢复型部署逻辑

边界与注意点

  • 仅需一条临时命令、不要求成体系脚本时,不必上本技能。
  • 环境只允许严格 POSIX sh(不能依赖 Bash 专有语法)时,应换用对应规范而非强行 Bash。
  • 安全:破坏性操作要有确认或 dry-run;非必要不以 root 执行。

任务与 shell 无关时,不要硬套本技能。

使用场景

  • 在 Jenkins/GitLab CI 里维护部署脚本,要求某步失败后整段作业必须立刻退出并留下可追的日志
  • 要把多台机器上的日志轮转与清理做成定时任务,需先 dry-run 再执行真正的删除
  • 编写跨 Ubuntu 与 macOS 的安装引导脚本,需在开头探测 shell 与路径并校验用户传入的安装目录
  • 为内部发布流水线写 pre/post hook,要在异常时 trap 清理临时目录并回报非零退出码

适合人员

  • 负责自建 CI 流水线的平台工程师,需要把脆弱的 shell 步骤改成可审计、可失败快速中止的实现
  • 驻场运维要把手工巡检串成 Bash 自动化,但担心误删数据或静默失败影响业务
  • SRE 在迭代蓝绿/金丝雀部署脚本,要求统一错误处理、日志格式与跨环境行为一致
  • 开源维护者想为项目提供可长期维护的安装/打包脚本库,而非复制粘贴的一次性片段