스킬 shellcheck-configuration
📦

shellcheck-configuration

안전

ShellCheck 를 설정하여 셸 스크립트 품질 관리

또한 다음에서 사용할 수 있습니다: wshobson

셸 스크립트에는 수동으로 발견하기 어려운 미묘한 버그와 이식성 문제가 자주 포함됩니다. 이 스킬은 ShellCheck 를 구성하고 사용하여 셸 스크립트 문제를 자동으로 감지하고 수정하는 방법에 대한 포괄적인 지침을 제공합니다.

지원: Claude Codex Code(CC)
⚠️ 68 나쁨
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"shellcheck-configuration" 사용 중입니다. 다음에서 SC2086 을 어떻게 수정하나요: for i in $list; do echo $i; done

예상 결과:

SC2086 은 단어 분할을 유발하는 인용되지 않은 변수에 대해 경고합니다. 수정: 배열의 경우 "$list" 또는 "${list[@]}"를 사용하세요. 수정 후: for i in "$list"; do echo "$i"; done

"shellcheck-configuration" 사용 중입니다. 엄격한 Bash 검증을 위한 .shellcheckrc 생성

예상 결과:

shell=bash 를 설정하고 require-variable-braces 와 같은 선택적 검사를 활성화하며 SC1091(소싱된 파일을 찾을 수 없음) 을 프로젝트 기본값으로 비활성화하는 구성.

"shellcheck-configuration" 사용 중입니다. 가장 일반적인 ShellCheck 오류는 무엇인가요?

예상 결과:

상위 5 개: SC2086(인용되지 않은 변수), SC1091(소싱된 파일), SC2154(설정되지 않은 변수), SC2148(팁), SC2164(|| exit 와 함께 cd 사용). 각각의 구체적인 수정사항은 스킬에서 자세히 설명합니다.

보안 감사

안전
v1 • 2/25/2026

All 111 static findings are false positives. The skill contains shell command examples used to demonstrate ShellCheck error codes (SC2086, SC1091, etc.). The scanner misidentified 'SC' as 'C2' keywords. URLs point to legitimate ShellCheck project resources. References to ~/.shellcheckrc and ~/.bashrc are standard config file paths, not malicious file access. The skill is purely educational documentation for ShellCheck static analysis tool.

1
스캔된 파일
469
분석된 줄 수
5
발견 사항
1
총 감사 수

높은 위험 문제 (1)

SKILL.md:80SKILL.md:110SKILL.md:113SKILL.md:116SKILL.md:119SKILL.md:122SKILL.md:125SKILL.md:129SKILL.md:132SKILL.md:137SKILL.md:140SKILL.md:144SKILL.md:183SKILL.md:218-219SKILL.md:286SKILL.md:292SKILL.md:296SKILL.md:307SKILL.md:318SKILL.md:333SKILL.md:347SKILL.md:357SKILL.md:424
False Positive: Scanner misidentified ShellCheck error codes as C2 keywords
The static scanner flagged 'C2 keywords' at multiple lines (80, 110, 113, 116, etc.), but these are actually ShellCheck error codes like SC2086, SC1091, SC2119. The scanner misread 'SC' as 'C2'. This is a documentation skill teaching users about ShellCheck error codes - no actual C2/malware content exists.
중간 위험 문제 (3)
SKILL.md:22SKILL.md:47-62SKILL.md:62-68
False Positive: Shell command examples are documentation content, not execution
The static scanner flagged 'external_commands' (73 occurrences) showing backticks, $(), and shell invocations. These are example shell script patterns shown in the skill to demonstrate what ShellCheck will detect. The skill is teaching users about ShellCheck - not executing these commands.
SKILL.md:55SKILL.md:466SKILL.md:467SKILL.md:468
False Positive: Network URLs are legitimate ShellCheck project resources
Hardcoded URLs point to github.com/koalaman/shellcheck and shellcheck.net - the official ShellCheck project and documentation. These are appropriate resources for a ShellCheck configuration skill.
SKILL.md:93SKILL.md:138
False Positive: Filesystem references are standard shell config paths
References to ~/.shellcheckrc and ~/.bashrc are standard configuration file paths in shell scripting. These are not malicious file access attempts - they are example configuration file locations.
낮은 위험 문제 (1)
SKILL.md:263
False Positive: sudo apt-get install is legitimate installation instruction
Line 263 shows 'sudo apt-get install shellcheck' which is the standard way to install ShellCheck on Debian/Ubuntu systems. This is not privilege escalation for malicious purposes.
감사자: claude

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
32
커뮤니티
78
보안
100
사양 준수

만들 수 있는 것

DevOps 엔지니어: CI/CD 파이프라인 설정

GitHub Actions, GitLab CI 또는 기타 CI/CD 시스템에서 배포 전 문제를 catch 하기 위한 자동화된 셸 스크립트 린팅 설정.

소프트웨어 개발자: 스크립트 품질 개선

ShellCheck 가이드를 사용하여 기존 셸 스크립트 오류를 수정하고 다양한 Unix/Linux 환경에서 이식성 개선.

시스템 관리자: 팀 코드 표준

프로젝트 수준 구성과 pre-commit 검증을 통해 팀 스크립트 전체에 일관된 코드 품질 표준 적용.

이 프롬프트를 사용해 보세요

ShellCheck 설치 
macOS, Ubuntu 또는 소스에서 ShellCheck 를 어떻게 설치하나요?
오류 코드 이해 
ShellCheck 오류 SC2086 은 무엇을 의미하며 스크립트에서 어떻게 수정하나요?
프로젝트 설정 구성 
SC1091 및 SC2119 를 비활성화하면서도 엄격한 검사를 활성화하는 Bash 프로젝트용 .shellcheckrc 구성 파일을 생성하세요.
CI/CD 통합 
모든 .sh 파일을 검사하고 문제가 발견되면 빌드를 실패하게 하는 GitHub Actions 워크플로우에 ShellCheck 를 통합하는 방법을 보여주세요.

모범 사례

  • 병합 전 문제를 발견하기 위해 CI/CD 파이프라인에서 ShellCheck 실행
  • 대상 셸을 올바르게 구성 - POSIX sh 로 Bash 스크립트 분석하지 않기
  • 인라인 지시문을 사용하여 특정 경고를 억제하는 이유 문서화

피하기

  • 왜 나타나는지 이해하지 않고 경고 비활성화
  • 잘못된 셸 방언으로 스크립트 분석 (sh 로 Bash)
  • 근본 문제를 해결하지 않고 ShellCheck 출력 무시

자주 묻는 질문

ShellCheck 란 무엇인가요?
ShellCheck 는 셸 스크립트에서 버그, 경고 및 문제를 찾는 정적 분석 도구입니다. Bash, sh, dash, ksh 및 기타 POSIX 셸을 지원합니다.
ShellCheck 를 어떻게 설치하나요?
macOS: brew install shellcheck. Ubuntu/Debian: apt-get install shellcheck. 또는 github.com/koalaman/shellcheck 에서 소스로 빌드.
ShellCheck 오류 코드는 무엇을 의미하나요?
코드는 그룹화됩니다: SC1000-1099(파서 오류), SC2000-2099(셸 문제), SC2100-2199(인용), SC3000-3999(POSIX 준수). 각 코드에는 구체적인 지침이 있습니다.
특정 경고를 어떻게 억제하나요?
인라인 지시문 사용: # shellcheck disable=SC2086. 또는 프로젝트 전체에서 억제하려면 disable=SC2086 과 함께 .shellcheckrc 를 구성하세요.
ShellCheck 가 보안 문제를 감지할 수 있나요?
ShellCheck 는 인용되지 않은 변수와 같은 일부 보안 관련 패턴을 감지하지만 보안 스캐너는 아닙니다. 취약점 평가를 위해 전용 보안 도구를 사용하세요.
편집기에 ShellCheck 를 어떻게 통합하나요?
대부분의 편집기에 ShellCheck 플러그인이 있습니다: VS Code(vscode-shellcheck), Sublime Text, Vim(ale 플러그인), Emacs(flycheck). 이들은 실시간 피드백을 제공합니다.

개발자 세부 정보

작성자

sickn33

라이선스

MIT

리포지토리

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/shellcheck-configuration

참조

main

파일 구조

📄 SKILL.md