shell-review
审计 Shell 脚本的正确性、可移植性与常见陷阱
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：shell-review。 它的用途是：审计 Shell 脚本的正确性、可移植性与常见陷阱 完整的 Skill 内容见：https://321skill.com/skills/shell-review-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用 shell-review 审计当前目录下的所有 .sh 文件，输出 JSON 格式的报告。' 它会自动安装工具（如果未安装）并运行审计，然后返回问题列表，包括每个问题的位置、严重级别和修复建议。
介绍
编写 Shell 脚本时，一个细微的错误可能导致数据丢失或服务中断，而跨平台兼容性问题更是令人头疼。shell-review 专门用于审计 Shell 脚本，能自动检测语法错误、可移植性问题以及常见的编码陷阱，帮助你在上线前发现并修复隐患。
使用方式非常简单：安装后，只需对指定脚本文件或目录运行审计命令，工具会立即输出问题列表，包括问题位置、严重等级和具体的修复建议。支持 bash、sh、zsh 等多种 Shell 方言，并可以配置自定义规则集。
适合运维工程师、后端开发、全栈开发以及测试工程师等所有需要编写或维护 Shell 脚本的人员。无论是日常开发中的快速检查，还是 CI/CD 流水线中的自动化质量门禁，它都能显著降低脚本引入的故障风险。
建议在项目中将其作为预提交钩子或持续集成环节的一部分，每次提交前自动审计。注意，审计结果本质上是静态分析，可能存在误报，需要结合脚本的实际运行环境进行判断和调整。
核心特点
与 shellcheck 等通用静态分析工具相比，shell-review 更侧重可移植性（如不同 sh 变体的兼容写法）和常见陷阱（如未引用的变量、管道错误处理），规则更贴近实际运维场景，误报率更低。
注意事项
不适合需要运行时上下文或动态执行分析的场景，如需要跟踪变量运行时值或依赖外部状态。
常见问题
shell-review 支持哪些 shell 解释器？
支持 bash、sh、zsh、dash 等主流 shell，并针对不同解释器的可移植性差异提供专项检查。
shell-review 和 shellcheck 有什么区别？
shell-review 在 shellcheck 的检查基础上，增加了更多关于可移植性（如 POSIX 兼容性）和常见陷阱（如 while read 管道中的变量作用域）的规则，更适合跨平台部署场景。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/shell-review-x/raw/index.md 读取 shell-review 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/shell-review-x/raw/index.md（查看排版版本）