Bash
Bash脚本编写、调试与加固专家
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Bash。 它的用途是:Bash脚本编写、调试与加固专家 完整的 Skill 内容见:https://321skill.com/skills/bash-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的Bash部署脚本在文件名包含空格时总是报错,而且set -e好像没起作用,请帮我修复并加固。' 它会逐行检查脚本,在引用变量处加上双引号,添加set -euo pipefail和trap,并针对macOS和Linux的差异做兼容处理,最终输出一个安全、可移植的脚本。
介绍
您是否经常遇到Bash脚本在文件名包含空格时崩溃、set -e莫名其妙失效、或者脚本在macOS上正常但在Linux上报错?这个Skill专门解决Bash脚本开发中的各种顽固问题,包括引用错误、数组使用陷阱、strict mode配置、trap信号处理、参数解析、以及macOS/Linux/WSL/POSIX sh之间的可移植性。它能够帮助您快速定位并修复变量未定义、bad substitution、command not found、ambiguous redirect等常见错误,还能处理shellcheck报告的SC2086等警告。
使用方法非常简单:您只需将需要编写或审查的Bash脚本粘贴给AI,或者描述您遇到的具体问题(如“脚本在cron下运行失败”),它会逐行分析代码,指出潜在风险,并给出修复后的代码段。它也支持直接生成符合安全规范的新脚本,自动添加strict mode、引号保护、错误处理等最佳实践,确保脚本在交互式终端、cron、systemd、sudo、CI runner等不同环境下稳定运行。
这个Skill适合所有需要编写或维护Bash脚本的开发者和运维人员,包括后端开发、全栈开发、运维工程师、DevOps工程师、以及经常使用Shell脚本的智能体开发者。无论您是在编写部署脚本、容器entrypoint、CI步骤、cron任务,还是简单的one-liner,它都能大幅提升脚本的健壮性和可维护性。
使用建议:在编写脚本时,建议先由本Skill生成基础框架,再根据实际需求调整;在审查现有脚本时,可以指定要检查的特定问题(如引用安全、错误处理、可移植性等)。需要注意的是,本Skill主要针对Bash、sh及兼容的Shell环境,不适用于交互式zsh或fish配置,也不处理PowerShell或操作系统级别的cron/systemd/权限问题。
核心特点
与通用的Shell代码审查工具不同,这个Skill不仅修复语法错误,还会主动强化脚本的防御性编程(如安全引用、IFS处理、set -euo pipefail、trap清理),并专门针对macOS Bash 3.2和GNU/Linux之间的差异给出适配方案,覆盖从简单脚本到复杂部署场景的全链路。
注意事项
不适用于交互式zsh或fish配置,不适用于PowerShell,也不处理主机级别的cron、systemd或权限故障(需由Linux系统工具处理)。
常见问题
如何让Bash脚本在macOS和Linux上都能运行?
使用本Skill时,它会自动检测并替换macOS Bash 3.2不支持的特性(如关联数组、+=运算符),并提供兼容写法,同时处理getopt、readlink等命令的差异。
脚本在cron下运行失败,但在终端正常,怎么办?
本Skill会分析cron环境与交互式环境的差异(如PATH、环境变量、stdin等),并给出修复建议,比如在脚本开头显式设置PATH、使用绝对路径、添加set -e等。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bash-x-2/raw/index.md 读取 Bash 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bash-x-2/raw/index.md(查看排版版本)