Agent Skills
返回列表
💻

Bash 脚本最佳实践

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sammcj-agentic-coding-shell-scripting。

技能介绍

要解决什么问题

很多 Bash 脚本在上线后才发现:$var 未加引号导致路径含空格时静默出错、set -e 未配合 pipefail 让管道前半段失败被掩盖,或脚本长到数百行却仍用字符串凑业务逻辑。本技能围绕「可维护、可移植、少踩坑」给出可执行的工程规范,而不是泛泛的 Shell 教程。

技能如何工作

从 何时该用 Shell 开始:适合百行内的编排、包装与简单流水线;复杂数据结构、重错误处理或超大约 100 行时应考虑 Python、Go 等。强制基础包括 #!/usr/bin/env bash、set -euo pipefail、提交前 ShellCheck 零告警,以及统一的脚本骨架。

核心能力覆盖日常模式:变量一律 "${var}"、入参校验、trap 做退出清理、函数内 local、数组处理含空格的列表、用 [[ ]] 做条件判断、优先内置命令与进程替换而非临时文件。进阶部分包括简单结构化日志、main 入口、幂等设计与安全的 while read(避免 pipe 进子 shell)。文末附带 完成前自检清单,便于 Code Review 对照。

适用边界

技能明确反对 eval、解析 ls 输出、反引号替换等反模式,并列出「应改用强类型语言」的信号:嵌套数组循环、重字符串处理、需单测函数等。Shell 的定位是 粘合工具,不是承载复杂业务;按此边界写脚本,才能长期有人敢改。

使用场景

  • 为 CI 写几十行的构建/部署包装脚本,需要统一 `set -euo pipefail` 与依赖检查
  • 维护调用 `kubectl`/`docker` 的编排脚本,要避免管道静默失败和未引用变量
  • Code Review 同事的 `.sh` 时,用清单核对引号、`trap`、幂等与 ShellCheck
  • 脚本要从 200 行膨胀前评估是否应改写为 Python,并按技能中的复杂度信号拍板

适合人员

  • 负责发布流水线的平台工程师,希望部署脚本失败即停、错误信息打到 stderr
  • 在 macOS 与 Linux 间共享运维脚本的基础设施同学,需要可移植 shebang 与 ShellCheck 习惯
  • 带初级同事写自动化脚本的 Tech Lead,要有一套可复制的模板与反模式清单
  • SRE 编写健康检查或告警胶水脚本,要求幂等、可重复执行且不滥建临时文件