1928 Analyze 71a0640d

Analyze Workflow

Analyze shell scripts with ShellCheck and present findings.

Trigger

• "shellcheck this script"
• "lint my shell script"
• "check for shell errors"
• "analyze bash script"

Process

1. Identify Scripts

Find shell scripts to analyze:

# Single file provided
shellcheck "$FILE"

# Find all scripts in directory
find . -type f \( -name "*.sh" -o -name "*.bash" -o -name "*.zsh" \) ! -path "./.git/*"

# Or detect by shebang
find . -type f ! -path "./.git/*" -exec sh -c '
    head -1 "$1" | grep -qE "^#!.*(bash|sh|zsh|ksh)" && echo "$1"
' _ {} \;

2. Run ShellCheck

# JSON output for parsing
shellcheck -f json "$SCRIPTS" 2>/dev/null

# GCC format for quick viewing
shellcheck -f gcc "$SCRIPTS"

# With all optional checks enabled
shellcheck -o all -f json "$SCRIPTS"

3. Parse and Present Results

Group findings by severity:

# Count by severity
shellcheck -f json script.sh | jq 'group_by(.level) | map({level: .[0].level, count: length})'

4. Output Format

Present findings in structured format:

## ShellCheck Analysis: script.sh

### Summary
- **Errors:** 2
- **Warnings:** 5
- **Info:** 3
- **Style:** 1

### Findings

#### Errors (Must Fix)

**SC2086** (line 15): Double quote to prevent globbing and word splitting.
```bash
# Line 15
echo $variable
# Fix
echo "$variable"

Wiki: SC2086

Warnings

SC2046 (line 23): Quote this to prevent word splitting.

# Line 23
files=$(ls *.txt)
# Fix
files="$(ls *.txt)"

Wiki: SC2046

Quick Fixes

Apply auto-fixes with:

shellcheck -f diff script.sh | patch -p1

## Example Invocations

```bash
# Basic analysis
shellcheck script.sh

# Strict analysis (all checks)
shellcheck -o all -S warning script.sh

# Check multiple files
shellcheck scripts/*.sh

# Recursive directory
find . -name "*.sh" -exec shellcheck {} +

# With specific shell
shellcheck -s bash script.sh

Integration with Workflows

After analysis, suggest:

1. Auto-fix available issues:

   shellcheck -f diff script.sh | patch -p1
   

2. Configure suppressions for false positives

3. Set up pre-commit hook for continuous validation