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 格式),按其中说明在我的环境里完成安装和配置。