Openclaw용 Git 커밋 포맷터

git diff 또는 텍스트 설명을 몇 초 만에 표준화된 컨벤셔널 커밋 메시지로 변환하는 지능형 유틸리티입니다.

wipal
v1.0.0
Mar 8, 2026
0
1k
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install git-commit-formatter

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 git-commit-formatter 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Git 커밋 포맷터란 무엇인가요?

Git 커밋 포맷터는 고품질의 표준화된 커밋 메시지 생성을 자동화하기 위해 설계된 전문 도구입니다. Conventional Commits v1.0.0 사양을 엄격히 준수하여 프로젝트 히스토리를 깔끔하고 전문적이며 탐색하기 쉽게 유지합니다. 이 도구는 Openclaw Skills 생태계의 핵심 구성 요소로, 개발자가 팀 전체의 버전 관리 워크플로에서 100% 일관성을 유지할 수 있도록 돕습니다.

복잡한 코드 변경이든 간단한 문서 업데이트든, 이 스킬은 작업의 문맥을 분석하여 가장 적절한 유형(type), 범위(scope) 및 제목(subject line)을 제안합니다. 수동 포맷팅과 관련된 추측과 정신적 피로를 제거하여 에이전트가 진행 상황 기록을 처리하는 동안 귀하는 기술적 구현에 집중할 수 있게 해줍니다.

Git 커밋 포맷터 활용 사례

  • 신속한 개발 주기 동안 원시 git diff 출력을 포맷된 커밋 메시지로 변환.
  • 자동화된 변경 로그 생성을 가능하게 하기 위해 오픈 소스 프로젝트의 커밋 히스토리를 표준화.
  • 메시지 구조에 대한 단일 소스를 제공하여 팀 내 커밋 스타일의 불일치 해결.
  • 명확한 명령조 설명을 통해 주요 변경 사항(Breaking Changes) 및 다중 모듈 리팩토링 기록.

Git 커밋 포맷터 작동 원리

  1. 사용자는 원시 Git diff 출력 또는 변경 사항에 대한 수동 텍스트 설명을 입력합니다.
  2. 스킬은 입력을 파싱하여 수정된 파일, 추가된 로직 또는 삭제된 줄과 같은 주요 정보를 추출합니다.
  3. 키워드 로직 및 변경 패턴을 기반으로 올바른 커밋 유형(feat, fix, docs, style, refactor, test 또는 chore)을 결정합니다.
  4. 변경 사항이 특정 모듈 또는 파일 경로로 국한된 경우 선택적 범위(kebab-case)를 식별합니다.
  5. 명령조를 사용하여 간결한 제목을 생성하며, 50자 제한을 유지합니다.
  6. 복잡한 변경의 경우, 수정의 '이유'를 설명하기 위해 한 줄당 72자 제한이 있는 본문을 구성합니다.
  7. 최종 메시지는 사용자에게 표시되기 전에 엄격한 체크리스트를 통해 검증됩니다.

Git 커밋 포맷터 설정 가이드

이 도구를 Openclaw Skills 워크플로에 통합하려면 작업 공간 구성에서 스킬이 활성화되어 있는지 확인하십시오.

# 스킬 디렉토리에 스킬이 있는지 확인
ls /data/workspace/skills/git-commit-formatter

# 수동 프롬프트 없이 자동 활성화를 사용하려면 화이트리스트를 업데이트하세요
nano /data/workspace/whitelist.yml

YAML 파일 내의 skills_allowed_auto_add 목록에 git-commit-formatter를 추가하여 개발 프로세스를 간소화하십시오.

Git 커밋 포맷터 데이터 스키마 및 분류 체계

이 스킬은 표준 git 파서와의 호환성을 보장하기 위해 다음 분류에 따라 커밋 메타데이터를 구성합니다.

구성 요소 필수 여부 검증 규칙
Type 필수 다음 중 하나여야 함: feat, fix, docs, style, refactor, test, chore
Scope 선택 소문자여야 하며 kebab-case 포맷 사용
Subject 필수 최대 50자, 명령조, 마침표 없음
Body 선택 제목 뒤에 빈 줄, 한 줄당 최대 72자
Footer 선택 BREAKING CHANGE 레이블 또는 Issue/PR 번호 참조용

Git 커밋 포맷터 고급 기능

  • 지능형 입력 파싱: Git diff 블록과 자연어 설명을 자동으로 구분합니다.
  • 화이트리스트 자동 통합: 마찰 없는 설정을 위해 시스템 화이트리스트를 통한 원활한 게이트웨이 배포를 지원합니다.
  • 주요 변경 사항 감지: 영향이 큰 수정을 식별하고 BREAKING CHANGE 푸터를 자동으로 구성합니다.
  • 다중 논리적 변경 처리: 더 나은 코드 리뷰를 위해 너무 큰 커밋을 여러 논리적 단위로 나누는 권장 사항을 제공합니다.
  • 터미널 최적화 포맷팅: 생성된 모든 텍스트가 CLI 환경에서 완벽하게 렌더링되도록 72자 너비 제한을 준수합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*