Menu
ShellCheck静态分析技能：使用ShellCheck进行Shell脚本代码质量分析，检测语法错误、潜在缺陷、代码风格问题
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
AI记忆持久化系统。使用memrec存储、检索、管理跨会话记忆。支持项目隔离、混合检索（KNN+BM25）、MMR重排、中文搜索。触发场景：(1)重要决策需记录，(2)关键知识需保存，(3)项目上下文需跨会话保持，(4)用户偏好需记忆，(5)检索历史知识辅助当前任务。
Rust 性能分析技能：通过 cargo flamegraph 生成火焰图(SVG)，定位 CPU 热点函数并量化占比。适用于 Rust 项目性能瓶颈定位、热点分析、优化验证。触发场景：(1)分析 Rust 代码性能瓶颈，(2)定位 CPU 热点函数，(3)量化函数调用占比，(4)优化前后对比验证，(5)bench/unittest 性能不达预期时根因分析。
读取所有源代码，解构为设计图、设计文档、数据库设计; 没有执行文件，请按流程执行
项目问题侦测技能：综合分析设计、性能、安全问题，评分并提出重构或重建方案
局部代码修改技能：最小化修改完成功能，确保无蝴蝶效应，支持独立测试验证和全量关联检查
该skill没有执行文件，为操作指引：如何重构
| name | shell-check |
| description | ShellCheck静态分析技能：使用ShellCheck进行Shell脚本代码质量分析，检测语法错误、潜在缺陷、代码风格问题 |
SHELLCHECK=/usr/bin/shellcheck
# 版本: ShellCheck 0.10.0
SCRIPT_FILE=script.sh # 单个文件
SCRIPT_DIR=scripts/ # 目录下的所有脚本
# 基础检查
$SHELLCHECK script.sh
# 检查目录下所有脚本
$SHELLCHECK scripts/*.sh
# 指定Shell方言
$SHELLCHECK --shell=bash script.sh
$SHELLCHECK --shell=sh script.sh
$SHELLCHECK --shell=dash script.sh
$SHELLCHECK --shell=ksh script.sh
$SHELLCHECK --format=json script.sh > shellcheck.json
$SHELLCHECK --format=json1 script.sh > shellcheck-detail.json
$SHELLCHECK --format=checkstyle script.sh > shellcheck.xml
$SHELLCHECK --format=gcc script.sh
$SHELLCHECK --format=quiet script.sh
使用模板 templates/report.md 输出分析报告。
| 参数 | 描述 | 示例 |
|---|---|---|
-s, --shell | 指定Shell方言 | --shell=bash |
-S, --severity | 最小严重级别 | --severity=error |
-e, --exclude | 排除特定警告 | -e SC2086,SC2034 |
-i, --include | 只包含特定警告 | -i SC2086,SC2034 |
-a, --check-sourced | 检查source的文件 | --check-sourced |
-x, --external-sources | 允许外部source | --external-sources |
-o, --enable | 启用可选检查 | --enable=all |
-f, --format | 输出格式 | --format=json |
| 级别 | 描述 |
|---|---|
error | 错误，必须修复 |
warning | 警告，建议修复 |
info | 信息，可选修复 |
style | 风格，可选修复 |
# shellcheck disable=SC2086
echo $var
# shellcheck disable=SC2086,SC2034
echo $var
# shellcheck disable-next=SC2086
echo $var
$SHELLCHECK -e SC2086,SC2034 script.sh
$SHELLCHECK -i SC2086 script.sh
disable=SC2086
shell=bash
source-path=SCRIPTDIR
enable=require-variable-braces
| 检查项 | 描述 |
|---|---|
require-variable-braces | 要求变量使用大括号 |
add-default-case | case语句需要默认分支 |
quote-safe-variables | 引用安全的变量 |
useless-use-of-cat | 检测无用的cat使用 |
| 场景 | 命令 |
|---|---|
| 快速检查 | $SHELLCHECK --severity=error script.sh |
| 完整检查 | $SHELLCHECK --enable=all --severity=style script.sh |
| CI集成 | $SHELLCHECK --format=gcc --severity=warning scripts/*.sh |
| 检查sourced文件 | $SHELLCHECK --check-sourced --source-path=scripts script.sh |
[[ ]]而非[ ]$( )而非反引号set -e技能版本: 1.0.0 工具版本: ShellCheck 0.10.0 适用项目: Shell脚本（bash/sh/dash/ksh）