Bash
编写、调试与加固Bash脚本,解决跨平台与常见陷阱问题。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Bash。 它的用途是:编写、调试与加固Bash脚本,解决跨平台与常见陷阱问题。 完整的 Skill 内容见:https://321skill.com/skills/bash-x-6/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我有一个Bash脚本,在Linux上运行良好,但在macOS上报‘bad substitution’错误,涉及数组操作,该怎么修改?” 它会分析macOS bash 3.2与更新版本在数组语法上的差异,提供兼容的写法。或者
对AI说:“我的部署脚本在手动执行时成功,但在CI流水线里总是静默退出,即使用了`set -e`。” 它会帮你检查脚本中可能导致`set -e`失效的特定命令或结构,并给出加固建议。
介绍
这个Skill专门用于解决Bash shell脚本编写、调试和加固过程中的各类棘手问题。无论是脚本在文件名包含空格时崩溃、静默退出、忽略set -e指令,还是出现引用、数组、进程替换、信号捕获(trap)等语法或行为异常,它都能提供专业指导。它尤其擅长处理因环境差异(如macOS bash 3.2与GNU/Linux、WSL、POSIX sh之间)导致的脚本不兼容问题,以及脚本在cron、systemd、sudo或CI运行器中表现异常的情况。
使用时,你可以直接向AI描述你遇到的Bash脚本问题,例如错误信息、脚本片段或期望的行为。AI会分析问题,提供修复方案、最佳实践代码示例,并解释背后的原理。无论是编写新脚本、审查现有代码,还是调试一个难以捉摸的bug,它都能作为你的实时顾问。
这个Skill非常适合需要编写或维护Shell脚本的开发者、运维工程师和系统管理员。无论你是编写部署脚本、容器入口点、CI步骤、cron作业,还是简单的自动化脚本,它都能帮助你写出更健壮、可移植和安全的代码。对于经常被shellcheck警告(如SC2086)困扰,或需要确保脚本在生产环境中可靠运行的用户来说,它尤其有价值。
建议在使用时,尽可能提供详细的上下文,如操作系统、Bash版本、错误信息和相关脚本代码。请注意,它专注于Bash脚本本身,对于交互式的zsh或fish配置、PowerShell脚本,以及主机级别的cron/systemd配置失败或权限问题,可能无法提供直接帮助。
核心特点
与通用编程助手不同,它深度聚焦于Bash脚本的独特陷阱和跨平台兼容性,能精准诊断由空格、IFS、引用、信号处理、`set -e`行为差异等引起的典型Shell问题,并提供符合ShellCheck标准的加固方案。
注意事项
不适用于交互式zsh/fish配置、PowerShell脚本,也不处理主机级别的cron、systemd服务配置或Linux权限故障。
常见问题
如何修复“ambiguous redirect”错误?
这通常由变量引用不当导致,建议对变量使用双引号,并检查命令替换的输出是否包含空格或特殊字符。
脚本在命令行运行正常,但在cron中失败怎么办?
通常与环境变量和路径有关,建议在脚本开头显式设置PATH等关键环境变量,并使用绝对路径。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bash-x-6/raw/index.md 读取 Bash 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bash-x-6/raw/index.md(查看排版版本)