SuperAPI AI 工具集

validate-skills

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:当编辑包含 fenced bash/shell 代码块的 .md 命令或技能文件时,建议运行 /validate-skills,在发布前发现问题。

主要能力:检测语法错误(未闭合引号、if/fi 不匹配、无效重定向,使用 bash -n);Shell 陷阱(未加引号的变量、废弃语法、SC2015 A && B || C,使用 shellcheck);可移植性问题(macOS 与 Linux 差异,如 mktemp 模板、sed -i、grep -P、readlink -f、date 参数);不安全命令(rm、sudo、eval、pipe-to-shell 等 RED 级命令标记为警告);模板变量处理(含 $CLAUDE_PLUGIN_ROOT、$ARGUMENTS、$MODEL 等无法解析的插件变量块跳过执行但仍做语法检查);执行失败(GREEN 级只读命令运行时失败,如 jq 过滤器错误、grep 模式无效、mktemp 模板错误)。

常见陷阱:macOS 上 mktemp 模板字符须在末尾,可用 mktemp /tmp/foo-XXXXXX 再重命名;sed -i ''(macOS)与 sed -i(Linux)差异,建议用 sed -i.bak;macOS 无 grep -P,改用 grep -E;macOS 无 readlink -f,改用 realpath 或 cd ... && pwd;date -d(Linux)与 date -j -f(macOS)不同。Shell 安全方面:A && B || C 不是 if/else,B 失败时 C 仍会执行(SC2015);未加引号的 $VAR 会按空白拆分并展开 glob,应写 "$VAR";[ -z $VAR ] 在 VAR 为空时失败,应写 [ -z "$VAR" ]。外部工具输出方面:不要假设输出是纯 JSON,需检查横幅、头部、进度条;curl 失败可能返回 HTML 错误页,需检查 HTTP 状态码;gh CLI 输出格式随版本变化,优先用 --json + --jq。

使用方式:/validate-skills 校验所有插件 .md 文件;/validate-skills plugins/go-dev/commands/ 校验目录;/validate-skills path/to/command.md 校验指定文件;/validate-skills --json 输出结构化 JSON。

适用场景:插件命令与技能 Markdown 的发布前检查。限制:资料未提供安装方式、收费、平台支持范围等更多信息。