AgentSkillsCN

language-shell

Shell脚本标准和安全实践。当需要Shell语言指导,或选择Shell作为轻量封装或接近操作系统的胶水层时使用。

SKILL.md
--- frontmatter
name: language-shell
description: Shell scripting standards and safety practices. Use when language shell guidance is required or when selecting Shell as a thin wrapper or OS-near glue layer.
allowed-tools:
  - Bash(shellcheck)

Key Execution Capabilities

Script Validation

  • Run syntax checking: bash -n, sh -n, zsh -n
  • Execute static analysis with shellcheck
  • Validate shebang lines and strict mode compliance
  • Check for security vulnerabilities and coding violations

Tool Integration

  • Use shellcheck for comprehensive linting
  • Leverage shell-specific parameter expansion features
  • Apply POSIX vs bash vs zsh feature detection
  • Implement platform-specific compatibility checks

Execution Context

  • Process script files from filesystem layer
  • Generate structured reports with line-by-line findings
  • Create minimal, rule-compliant patches for violations
  • Maintain separation between governance rules and execution tools

Error Handling

This skill provides execution-layer error handling for shell script analysis:

  • Invalid file formats or permissions
  • Tool availability issues (missing shellcheck, etc.)
  • Platform-specific limitations
  • Syntax validation failures

Usage Notes

  • Always delegate to governance rules for policy decisions
  • Focus on concrete tool execution and result processing
  • Provide deterministic, tool-first analysis results
  • Maintain separation between rule definition and rule application