Openclaw용 Smart Commit

Smart Commit은 스테이징된 변경 사항을 분석하여 Conventional Commits 표준에 따라 정확하고 구조화된 커밋 메시지를 생성하는 AI 기반 Git 유틸리티입니다.

wusuiling-if
v1.0.0
Mar 12, 2026
0
1.1k
0

설치 및 다운로드

1. ClawHub CLI

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

npx clawhub@latest install git-smart-commit

2. 수동 설치

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

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

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

3. 프롬프트 설치

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

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

다운로드를 원하시나요?

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

Smart Commit란 무엇인가요?

Smart Commit은 Openclaw Skills 에코시스템 내의 특화된 도구로, 수동으로 Git 메시지를 작성하는 번거로움을 없애기 위해 설계되었습니다. 스테이징된 diff를 검사하여 새로운 기능, 버그 수정 또는 성능 최적화와 같은 코드 변경의 의도를 지능적으로 식별하고 이를 표준화된 구조로 포맷합니다.

이 스킬은 프로젝트의 버전 히스토리를 깨끗하고 검색 가능하며 전문적으로 유지해 줍니다. 단순한 텍스트 생성을 넘어 breaking changes를 감지하고 너무 복잡한 diff에 대해 논리적 분할을 제안함으로써 Openclaw Skills를 버전 관리 관리에 사용하는 모든 개발자에게 필수적인 자산이 됩니다.

Smart Commit 활용 사례

  • 개발자가 수동 입력 없이 전문적인 커밋 메시지를 빠르게 생성하고 싶을 때.
  • 팀에서 자동화된 changelog를 위해 Conventional Commits 사양을 엄격히 준수해야 할 때.
  • 스테이징된 변경 사항이 복잡하여 주요 영향을 식별하기 위해 AI 기반 요약이 필요할 때.
  • 종속성 업데이트(chore)나 문서 수정(docs)과 같은 루틴 유지보수를 수행할 때.

Smart Commit 작동 원리

  1. 스킬이 git diff --cached --stat을 실행하여 스테이징된 수정 사항의 상위 레벨 개요를 가져옵니다.
  2. git diff --cached를 통해 전체 diff의 심층 분석을 수행하여 로직 변경 사항을 이해합니다.
  3. AI가 적절한 타입(feat, fix, refactor 등)을 선택하고 파일 경로를 기반으로 관련 범위(scope)를 추론합니다.
  4. 초안 메시지가 생성되어 사용자에게 검토를 위해 제시됩니다.
  5. 승인 시, 스킬이 최종 git commit -m 명령을 실행하여 변경을 완료합니다.

Smart Commit 설정 가이드

이 기능을 워크플로우에 통합하려면 Openclaw 환경이 구성되었는지 확인하고 터미널에서 다음을 실행하세요.

# git 저장소로 이동
cd your-project-repo

# 변경 사항 스테이징
git add .

# AI 에이전트를 통해 smart-commit 스킬 트리거
openclaw run smart-commit

Smart Commit 데이터 스키마 및 분류 체계

Smart Commit은 Git의 내부 메타데이터와 Conventional Commits 분류법을 사용하여 정보를 구성합니다.

구성 요소 소스 설명
Type Diff Analysis 변경 분류 (예: feat, fix, style)
Scope File Path 영향받는 모듈 식별 (예: api, ui)
Subject Hunk Analysis 변경 사항에 대한 명령형 설명
Breaking Change Code Impact breaking API 또는 로직 변경 감지

대규모 diff(4000행 이상)의 경우, token 효율성을 유지하기 위해 git diff --stat을 기반으로 요약을 생성합니다.

Smart Commit 고급 기능

  • Breaking Change 감지: 헤더에 자동으로 !를 추가하고 BREAKING CHANGE: 푸터를 채웁니다.
  • 커스텀 범위 설정: --scope 및 --type 플래그를 사용하여 특정 범위나 타입을 강제하는 기능.
  • Amending 지원: --amend 옵션을 사용하여 마지막 커밋 메시지를 원활하게 업데이트.
  • Dry Run 모드: 정확성 확인을 위해 커밋 명령을 실행하지 않고 생성된 메시지를 검토.
  • 대규모 Diff 샘플링: 컨텍스트가 손실되지 않도록 대규모 변경 세트에 대한 지능형 hunk 샘플링.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*