SuperAPI AI 工具集

shell-scripting

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

该技能用于编写和审查 shell 脚本时提供规范与防御性模式,目标是抵消 shell 默认行为带来的隐性缺陷。

用途:脚本编写与代码审查。编写时静默套用全部规则,产出干净、防御性的代码;审查时指出被违反的具体规则并给出内联修复,优先级为引号缺陷高于错误处理缺口高于风格问题。

主要能力:

  • 严格模式:脚本头部使用 #!/usr/bin/env bash 与 set -euo pipefail,并说明 errexit 的例外(if/while 条件、&&/|| 左侧、取反命令)。
  • 引号规则:变量与命令替换加双引号,用 "$@" 而非 $*,数组用 "${arr[@]}",通配符不加引号,数据输出用 printf 而非 echo。
  • 错误处理:检查每个可能失败的命令,cd 等用 || exit 1;用 trap 在 EXIT 时清理;临时文件用 mktemp;错误信息输出到 stderr;退出码约定 1 通用、2 用法、64+ 应用级。
  • 变量与函数:局部变量小写下划线、常量与导出变量大写并用 readonly;函数内用 local;local 与命令替换分行写以免遮蔽退出码;用 main "$@" 作为入口。
  • 控制流:bash 用 [[ ]],数值比较用 (( ));不用 ls 解析输出,用 glob 与 while IFS= read -r;用进程替换避免子 shell 变量丢失;find -print0 配合 read -d ''。
  • 输入处理:getopts 处理短选项,手写长选项解析,处理 --,给变量传参时加 --,用 command -v 检测程序是否可用。
  • 可移植性:区分 POSIX sh 与 bash,macOS 自带 bash 3.2,避免 GNU 专有选项。
  • ShellCheck:用禁用指令注释处理有意违规,并列出 SC2086、SC2046、SC2034、SC2155、SC2164 等常见代码。

使用方式:技能以规则与参考文档形式提供,随附严格模式、引号、可移植性、参数解析、陷阱、内建替代等参考文件(位于 ${CLAUDE_SKILL_DIR}/references/ 下)。

限制:面向 shell/bash 的正确性规则,不负责通用编码流程或语言专有工具链;具体与其它插件如何集成、安装方式与许可信息暂未提供。