shellcheck-configuration

개요

shellcheck-configuration이란?

shellcheck-configuration은 개발자와 DevOps 팀이 셸 스크립트용 정적 분석 도구인 ShellCheck를 설정하고 활용할 수 있도록 돕는 스킬입니다. 린팅 인프라 구축, 코드 문제 해결, 환경 간 스크립트 이식성 확보를 위한 실용적인 가이드를 제공합니다. 이 스킬은 모범 사례를 적용하고, 흔한 셸 스크립트 오류를 잡아내며, CI/CD 파이프라인에 품질 검사를 통합하려는 모든 분께 적합합니다.

누가 사용해야 하나요?

• Bash, sh, dash, ksh 스크립트를 작성하는 개발자
• 자동화 스크립트를 관리하는 DevOps 엔지니어
• 셸 스크립트 코드 품질 기준을 적용하는 팀
• CI/CD 워크플로우에 셸 스크립트 린팅을 통합하려는 분

해결하는 문제

• 흔한 셸 스크립트 오류 및 함정 감지
• 일관된 코딩 표준 적용
• 품질 기준 충족을 위한 스크립트 마이그레이션 지원
• 프로젝트별 설정과 오탐 억제 기능 지원

사용 방법

설치 단계

1. 다음 명령어로 스킬을 설치하세요:
   npx skills add https://github.com/wshobson/agents --skill shellcheck-configuration
2. SKILL.md 파일에서 구성 및 사용법에 대한 자세한 안내를 확인하세요.
3. 추가 정보는 README.md, AGENTS.md, metadata.json 파일을 참고하세요.

ShellCheck 설치

• 플랫폼에 맞는 패키지 관리자를 사용해 ShellCheck를 설치하세요:
  • macOS: brew install shellcheck
  • Ubuntu/Debian: apt-get install shellcheck
  • 소스에서 설치: 공식 저장소를 클론한 후 make build && make install 실행
• shellcheck --version 명령어로 설치를 확인하세요

ShellCheck 구성

• 프로젝트에 .shellcheckrc 파일을 만들어 규칙과 대상 셸을 맞춤 설정하세요.
• 자동 린팅을 위해 ShellCheck를 CI/CD 파이프라인에 통합하세요.
• 프로젝트 요구에 맞게 ShellCheck 플래그를 활용하세요.

워크플로우 적응

• 제공된 스킬 파일을 시작점으로 삼아 저장소와 도구에 맞게 구성을 조정하세요.
• 설정을 그대로 복사하지 말고 팀의 필요와 운영 환경에 맞게 맞춤화하세요.

자주 묻는 질문

구성 예시는 어디서 볼 수 있나요?

SKILL.md와 .shellcheckrc 파일에서 샘플 구성과 권장 방식을 확인할 수 있습니다.

shellcheck-configuration을 CI/CD에 사용할 수 있나요?

네, 이 스킬은 CI/CD 파이프라인에 쉽게 통합되어 자동 셸 스크립트 린팅과 품질 검사를 지원합니다.

어떤 셸을 지원하나요?

ShellCheck는 Bash, sh, dash, ksh 및 기타 POSIX 호환 셸을 지원합니다.

오탐을 어떻게 억제하나요?

.shellcheckrc 파일이나 스크립트 내 인라인 설정으로 규칙을 조정하고 특정 경고를 억제할 수 있습니다.

어디서부터 시작해야 하나요?

SKILL.md 파일을 먼저 살펴보고 전체 개요를 파악한 후, 다른 지원 파일들을 참고해 더 깊이 있는 정보를 얻으세요. 파일 탭에서 전체 파일 트리와 참조, 헬퍼 스크립트도 확인할 수 있습니다.