AgentSkillsCN

shell-validate

在编辑Shell脚本后进行验证。适用于在local/bin/或scripts/目录下编写或修改任何Shell脚本时使用。

SKILL.md
--- frontmatter
name: shell-validate
description: Validate shell scripts after editing. Apply when writing or modifying any shell script in local/bin/ or scripts/.
user-invocable: false
allowed-tools: Bash, Read, Grep

After editing any shell script in local/bin/, scripts/, or config/ (files with a #! shebang or # shellcheck shell= directive), validate it:

1. Determine the shell

  • •/bin/sh or #!/usr/bin/env sh shebang -> POSIX, use sh -n
  • •/bin/bash or #!/usr/bin/env bash shebang -> Bash, use bash -n
  • •# shellcheck shell=bash directive (no shebang) -> use bash -n
  • •# shellcheck shell=sh directive (no shebang) -> use sh -n
  • •No shebang and no directive -> default to bash -n

2. Syntax check

Run the appropriate syntax checker:

bash
bash -n <file>   # for bash scripts
sh -n <file>     # for POSIX sh scripts

If syntax check fails, fix the issue before proceeding.

3. ShellCheck

Run shellcheck <file>. The project .shellcheckrc already disables SC2039, SC2166, SC2154, SC1091, SC2174, SC2016. Only report and fix warnings that are NOT in that exclude list.

Key files to never validate (not shell scripts)

  • •local/bin/fzf-tmux (vendor file)
  • •*.md files
  • •*.bats test files (Bats, not plain shell)