用途:指导编写生产质量的 Bash 脚本,目标为 Bash 4.0+,并强制符合 ShellCheck 规范。适用于 200 行以内的快速自动化、构建/部署脚本、系统管理与工具间胶水代码;不适合复杂业务逻辑、需要恢复的健壮错误处理、长期运行服务或需要单元测试的代码,超过约 200 行建议改用 Python 或 Go。
主要能力:强制脚本头部使用 #!/bin/bash 与 set -euo pipefail;条件判断统一用 [[ ]];变量展开统一加引号如 "${var}";命令替换用 $(command);算术用 (( ))。提供日志、校验、清理等基础函数示例,trap cleanup EXIT 清理临时目录,以及 while/case 参数解析模式。涵盖索引数组与 Bash 4+ 关联数组用法。安全规则包括禁用 eval、净化输入、系统命令用绝对路径、常量用 readonly、不在脚本中存放密钥。
使用方式:在修改任何 .sh 文件或 shell 脚本(含 pre-commit 等 git 钩子)前先激活 /bash 技能;完成后运行 shellcheck script.sh 或 shellcheck -s bash script.sh,要求零警告。常见修复包括 SC2086 加引号、SC2155 分开声明 local、SC1090 加 source 注释、SC2046 改用 while read。完整模板见 references/script-template.md,高级模式见 references/advanced-patterns.md。
限制:资料未提供安装命令、收费、价格与平台信息;未说明具体版本兼容范围之外的支持情况。