ShellCheck 静态检查配置

原名：shellcheck-configuration

按 Shell 类型检查引用、变量和可移植性，解释告警而不是直接全部忽略。

中文 Skills 技能说明

项目里 Bash 或 sh 脚本未经检查就上线时，可让开发岗位数字员工使用。提供脚本、目标 Shell、版本和现有规则，技能配置 ShellCheck、分析告警与必要的局部例外，交付检查设置和修复清单。静态检查不执行全部业务路径，告警消失不等于脚本安全。工具需桌面端自己配置，Windows 运行环境另行核对；不能为了通过检查批量屏蔽规则，修改和流水线接入须授权，正式执行与发布由人复核。

上游能力依据

上游原始适用说明：Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.

上游 SKILL.md 主要章节（保留原文标题）：

• When to Use This Skill
• Detailed patterns and worked examples
• Best Practices

使用边界

先复现问题并固定测试范围，再生成或执行测试。测试通过只能证明已覆盖的场景，不能代替生产环境验收。

作者、翻译与许可证

原作者

Seth Hobson（wshobson）与 agents contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/wshobson/agents/tree/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/shell-scripting/skills/shellcheck-configuration

适用范围

平台：linux、macos、windows；标签：测试与质量、ShellCheck 静态检查配置、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。