GitHub Actions 워크플로를 설정 오류 없이 작성하는 AI Skill을 구축했습니다

YAML을 직접 수동으로 작성하는 것을 멈추세요. 12개의 품질 게이트(Quality Gates), 5개의 결정 템플릿(Decision Templates), 3개의 필수 보안 설정(Security Configs)을 갖춘 AI 에이전트가 즉시 프로덕션 환경에 사용 가능한 워크플로를 생성하게 하세요.

문제점 (The Problem)

GitHub Actions YAML을 수동으로 작성하는 것은 오류가 발생하기 쉽습니다. permissions를 기억했나요? 액션(Action) 버전을 고정(Pin)했나요? 캐싱(Caching)을 설정했나요? 동시성(Concurrency)이 설정되었나요?

누락된 모든 설정은 빌드 속도 저하, 보안 취약점, 또는 비용이 발생하는 사용 시간의 낭비로 이어집니다.

해결책 (The Solution)

저는 모호한 프롬프트가 아닌, 실행 가능한 명령어 세트인 AI Skill을 구축했습니다. 이는 어떤 AI 에이전트라도 엄격한 파이프라인을 따르도록 강제합니다:

의사결정 트리 (Decision Tree) → 필수 설정 주입 (Mandatory Config Injection) → 캐시 매칭 (Cache Matching) → 12개 품질 게이트 (12 Quality Gates) → 프로덕션 YAML (Production YAML)

한 문장으로 즉각적인 결과 도출:

"내 Node.js 프로젝트에 CI를 추가해줘 — PR 시 eslint와 jest를 실행하도록 해줘"

AI가 내부적으로 생성하는 내용:

1. ✅ package.json 감지 → Node.js
2. ✅ 템플릿 A (CI) 선택됨
3. ✅ permissions: contents: read 주입됨
4. ✅ 자동 취소가 포함된 concurrency 설정
5. ✅ cache: 'npm' → 설치 속도 약 70% 향상
6. ✅ 모든 액션(Action)을 SHA-1으로 고정 (@v4가 아닌 @11bd71... 방식)
7. ✅ 12가지 체크리스트 검증 완료

5초 소요. 누락 제로.

차별점 (What Sets It Apart)

일반적인 LLM 채팅은 매번 설정을 놓칩니다. 이 Skill은 설정을 선택 사항이 아닌 필수 사항으로 만듭니다.

95%의 사용 사례를 커버하는 5가지 결정 경로 (5 Decision Paths)

• "lint / test / PR" → CI 워크플로 (CI Workflow)
• "Tag / Release / publish" → 릴리스 워크플로 (Release Workflow)
• "cron / scheduled / Dependabot" → 예약된 워크플로 (Scheduled Workflow)
• "security / CodeQL / scan" → 보안 워크플로 (Security Workflow)
• "Issue / triage / auto-label" → 자동화 워크플로 (Automation Workflow)

모든 템플릿은 예외 없이 **최소 권한 원칙(Least-privilege permissions), 동시성 제어(Concurrency control), 그리고 SHA-1 고정 액션(SHA-1 pinned actions)**을 강제합니다.

5가지 보안 레드라인 (5 Security Red Lines)

1. ❌ 하드코딩된 토큰 (Hardcoded tokens) → 차단됨
2. ❌ pull_request_target 오용 → 차단됨
3. ❌ 확인 없이 워크플로 (workflows) 덮어쓰기 → 차단됨
4. ❌ @main / @master 액션 참조 (action refs) → 차단됨
5. ❌ permissions: write-all → 차단됨

범용성 — 모든 AI 에이전트 (AI Agent)와 호환 가능

Before/After

# ❌ Skill 미적용 시 — 전형적인 일반 LLM 출력물
name: CI
on: push
...

사용해 보기

git clone https://github.com/2B0748/github-actions-skill.git

👉 유용하다고 생각되시면 저장소(repo)에 Star를 눌러주세요. 새로운 언어 템플릿이나 예외 케이스(edge cases)에 대한 PR(Pull Request)은 언제나 환영합니다.