菜单
ShellCheck静态分析技能：使用ShellCheck进行Shell脚本代码质量分析，检测语法错误、潜在缺陷、代码风格问题
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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）