Helper Script와 Slash Command 결합을 통한 Commit 일관성 확보

Slash commands: no more meaningless commits

Guilherme Yamakawa de Oliveira2026년 5월 1일6분intermediate

AI 요약

Context

AI Agent 기반의 단순 Commit 요청 시 발생하는 무분별한 파일 그룹화와 모호한 커밋 메시지 문제 분석. LLM에만 의존한 상태 분석은 토큰 낭비와 출력 결과의 비결정성(Non-deterministic)을 초래하는 한계 존재.

Deterministic Classification: Ruby 기반 Helper Script(bin/commit-survey)를 통해 파일 경로별 버킷 분류 로직을 외부화하여 결과 예측 가능성 확보
Token Optimization: git status 전체 결과 대신 분류된 결과값만 AI에게 전달하여 컨텍스트 윈도우 소비 절감
Multi-stage Pipeline: '파일 분류 -> 도메인별 그룹화 -> Conventional Commits 적용 -> 순차적 커밋'으로 이어지는 구조적 워크플로우 설계
Safety Layer: SKIP_PATTERNS 정의를 통한 환경 변수 및 보안 파일의 Staging 자동 제외 로직 구현
Configuration as Code: Markdown 파일을 통한 Slash Command 정의로 DSL 없이 프롬프트 엔지니어링의 모듈화 달성

실천 포인트

1. 반복적인 AI 프롬프트를 Markdown 기반의 Slash Command로 모듈화했는지 확인

2. LLM이 수행하기에 비용이 높거나 부정확한 분석 작업(예: 파일 경로 분류)을 외부 스크립트로 분리했는지 검토

3. Conventional Commits 표준을 프롬프트 내 단계별 지침으로 명시하여 일관성 강제

태그