Bash
编写、调试与加固Bash脚本,解决跨平台兼容性与常见陷阱。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Bash。 它的用途是:编写、调试与加固Bash脚本,解决跨平台兼容性与常见陷阱。 完整的 Skill 内容见:https://321skill.com/skills/bash-x-4/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我需要一个Bash脚本,用来备份指定目录到远程服务器,要求使用rsync,处理带空格的文件名,并记录日志和错误。',它会生成一个包含严格模式(set -euo pipefail)、错误处理trap、参数解析和详细日志记录的健壮脚本。或者,你可以说:'我的部署脚本在本地运行正常,但在Jenkins流水线里总是静默失败,帮我看看。',它会分析你的脚本,指出可能的环境差异、命令退出状态处理或信号问题。
介绍
这个Skill专门用于编写、调试和加固Bash shell脚本。它能帮你解决脚本开发中遇到的各种棘手问题,例如文件名包含空格时脚本崩溃、脚本静默退出、set -e被忽略、脚本挂起或返回错误退出码等。它还能正确处理引号、IFS、数组、heredoc、进程替换、trap、getopts、mapfile等复杂语法,并针对shellcheck的常见警告(如SC2086)提供解决方案。
当你需要编写或审查任何脚本、单行命令、cron作业、部署脚本、容器入口点或CI步骤时,都可以使用它。它尤其擅长诊断那些手动运行正常,但在cron、systemd、sudo或CI运行器中失败的脚本问题。
这个Skill非常适合需要编写可靠、可移植脚本的开发者、运维工程师和系统管理员。无论是处理日常自动化任务,还是构建复杂的部署流程,它都能提供专业的指导。
使用建议:在编写新脚本或调试现有脚本时,可以详细描述你的需求和遇到的问题。注意,它专注于Bash脚本本身,不适用于交互式的zsh或fish配置,也不处理PowerShell脚本或主机级别的cron、systemd或权限故障。
核心特点
与通用编程助手相比,它深度聚焦于Bash脚本特有的陷阱、最佳实践和跨平台(macOS bash 3.2, GNU/Linux, WSL, POSIX sh)兼容性问题,能提供从语法检查、错误调试到安全加固的一站式解决方案。
注意事项
不适用于交互式zsh或fish配置、PowerShell脚本,也不处理主机级别的cron、systemd或权限故障。
常见问题
如何修复脚本中因文件名空格导致的错误?
通常是由于引号使用不当。可以帮你检查并修正变量引用和命令参数中的引号。
为什么我的脚本在cron下不运行,但手动执行正常?
常见原因是环境变量(如PATH)不同或相对路径问题。可以帮你分析cron环境并修正脚本。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bash-x-4/raw/index.md 读取 Bash 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bash-x-4/raw/index.md(查看排版版本)