Community코딩 & 개발github.com

gitmoji

Gitmoji Triangle 규칙(이모지 쌍, 티켓, 범위, 요약)에 따라 깃 커밋을 작성하고, 스테이징된 작업을 결정 단위별로 분할합니다. 티켓의 커밋을 계획하기 전, `git commit` 전, `gitmoji` 커밋-메시지 훅이 제목을 거부할 때, 풀 리퀘스트를 병합할 때, 그리고 이전 기록에서 생성된 메시지를 검토할 때 사용하세요.

gitmoji란 무엇인가요?

이 스킬은 Gitmoji Triangle 규칙에 따라 깃 커밋 메시지를 구조화하는 방법을 제공합니다. 각 커밋 제목은 `<영역><행동 또는 의도>[수정자] <티켓>(<범위>): <요약>` 형식으로 작성되며, 이모지 쌍과 티켓 번호, 범위, 요약으로 구성됩니다. `gitmoji` 명령어를 통해 영역, 그룹, 수정자, 범위 등 다양한 용어 가이드를 제공하며, `gitmoji check -m '<제목>'`으로 커밋 전 유효성을 검증할 수 있습니다. 이 스킬은 코드 작성을 시작하기 전에 티켓을 읽고 예상되는 커밋들을 먼저 계획한 후, 각 커밋은 리뷰어가 독립적으로 수용할 수 있는 하나의 결정을 담도록 권장합니다. 잘못된 이모지나 단축 코드 사용을 방지하고, 모든 커밋에 본문을 작성하도록 강제합니다. 작성자로 에이전트를 등록하는 것을 금지하며, 대신 본문 끝에 모델, 하네스, 서브 에이전트 등 커밋에 기여한 요소를 명시하는 서명을 추가합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/D1no/gitmoji/tree/HEAD/skills/gitmoji

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Triangle 커밋

커밋 제목은 다음과 같은 형식을 따릅니다:

<영역><행동 또는 의도>[수정자] <티켓>(<범위>): <요약>
🧩👔 #412 (server): 거부 후 30일 이내 항소 허용
🎨💄 — (tokens): Figma에서 새 색조 가져오기

이모지는 줄의 첫 문자이며, 주변에 아무 것도 없습니다. 마지막 예시는 자동화 작업에 의한 커밋으로, 티켓이 없으므로 줄표(—)를 사용합니다.

의도적으로 용어집은 방대하므로, 모든 것을 머릿속에 담을 필요는 없습니다. gitmoji 명령어가 필요한 부분만 조금씩 제공합니다. 필요한 부분만 읽으십시오.

명령어

gitmoji 명령어를 사용하십시오. PATH에 없으면 이 스킬 폴더의 references/vocabulary.txt를 읽어 전체 용어집을 확인하고, 명령어가 없다고 사용자에게 알리십시오.

상황실행 명령어
영역 목록이 필요할 때gitmoji guide areas
영역을 알고 있을 때gitmoji guide 🧩 (영역 이모지 또는 이름)
영역 가이드에 맞는 항목이 없을 때gitmoji guide groups, 그 다음 그룹 하나: gitmoji guide "repair"
두 항목이 모두 맞는 것 같을 때gitmoji guide 🛡️, 또는 그룹: gitmoji guide "protection"
작업이 시험, 임시 방편 또는 호환성 파괴일 때gitmoji guide modifiers
범위 이름이 필요할 때gitmoji guide scopes
요약 또는 본문을 작성하려 할 때gitmoji guide message
git commit 전에gitmoji staged, 그 다음 gitmoji check -m '<제목>' (첫 줄 확인), 또는 gitmoji check <파일> (전체 메시지 확인)
:jigsaw::necktie: 같은 단축 코드를 입력했을 때아무 것도 하지 않음: 훅이 이모지를 자동으로 작성
커밋을 되돌릴 때git revert <커밋>; git 자체의 첫 줄은 그대로 둠
훅이 제목을 거부했을 때훅의 메시지를 읽으십시오. 수정 사항을 알려줍니다.
브랜치의 커밋을 병합 전에 검토할 때gitmoji history trunk..HEAD (병합 대상 브랜치, 그 다음 당신의 브랜치)
훅이 저장소가 다른 버전을 채택했다고 말할 때훅이 알려주는 주소에서 변경 사항을 읽고, 설정을 변경하기 전에 사용자에게 알리십시오.

코드를 작성하기 전: 커밋 계획하기

티켓을 읽고 예상되는 커밋 제목을 목록으로 작성하십시오. 각 커밋은 리뷰어가 독립적으로 수용할 수 있는 하나의 결정이어야 하며, 티켓에서 요구하는 사항이어야 합니다. 각 커밋의 범위는 해당 결정을 소유하는 패키지입니다(gitmoji guide scopes).

이는 채워야 할 스택이 아니라 프롬프트입니다. 티켓이 질문에 답을 주는 경우에만 커밋을 계획하십시오:

  • 비즈니스가 결정하는 것(👔)과 시간이 지남에 따라 발생하는 것(⛓️)은 무엇입니까?
  • 단계를 시도하기 전에 거부되는 것(🛡️)은 무엇입니까? 단계가 실패할 때 어떻게 복구되며, 어떤 오류 코드를 보고하고, 사용자에게 무엇을 알립니까(🥅)?
  • 구성 요소 간에 합의된 형태(🏷️)와 저장되는 것(💾)은 무엇입니까?
  • 사용자가 보고 수행하는 것은 무엇이며, 어떤 커밋에서 처음으로 이를 얻습니까(✨)?
  • 실제 제품에서 사용자가 이를 성공적으로 통과하는지 어떻게 알 수 있습니까(✅, 별도의 커밋, 제품이 그렇게 실행될 수 있을 때 한 번 추가)?

여정(journey)을 아직 실행할 수 없을 때는 기능을 출시하고 티켓에 ✅가 미해결 상태라고 명시하십시오. 간격을 메우기 위해 더 작은 체크 표시에 ✅를 넣지 마십시오. 그 용도는 ☑️입니다.

새로운 엔드포인트, 저장소 또는 정책을 계획하기 전에 기존 소유자가 있는지 확인하십시오. 제품 결정이 누락되어 출시되는 내용이 변경된다면, 질문을 기록하고 물어보십시오. 커밋 내에서 결정을 내리지 마십시오.

하나의 결정으로 구성된 기능, 단일 호출자 및 필요한 검사를 포함하는 기능은 하나의 커밋입니다. 티켓에 리뷰어가 별도로 수용할 수 있는 여러 결정이 있는 경우에만 더 많은 줄을 계획하십시오. 티켓에서 요청하지 않은 줄은 너무 세분화된 것입니다.

각 커밋 전: 네 가지 질문

  1. 변경 사항이 속한 영역은 무엇입니까? 테스트, 문서 및 플레이그라운드는 관련된 대상의 영역을 따릅니다.
  2. 지금 무엇이 다릅니까, 또는 무엇을 했습니까? 커밋이 약속된 사항을 변경하는 경우 행동(명사)을 명명하십시오. 그렇지 않으면 의도(동사)를 명명하십시오.
  3. 작업이 확정되지 않았습니까? 그럴 경우에만 세 번째 이모지를 추가하십시오: 🧪 시험, 🚧 임시 방편, 💥 소비자가 적응해야 함. 시험은 🏁(유지) 또는 ⚰️(폐기)될 때까지 모든 커밋에 🧪을 유지하며, 그 전까지는 확정된 어떤 것도 이에 의존할 수 없습니다. 티켓이 선택한 방향을 구축하는 것은 시험이 아닙니다.
  4. 어떤 티켓입니까? 저장소의 티켓 형식을 사용하십시오. 자동화 작업만 —를 사용합니다.

그런 다음 gitmoji check -m '<제목>'을 실행하십시오.

스테이징하기 전에, 당시 상황을 모르는 사람의 입장에서 변경 사항을 읽으십시오. 코드만으로 이유를 알 수 없는 경우, 코드 옆에 주석을 작성하십시오: 왜 이렇게 되었는지, 무엇이 변경되어서는 안 되는지, 값이 어디서 오는지. 줄이 무엇을 하는지 말고, 왜 그런지를 설명하십시오. 주석은 거의 비용이 들지 않으며, 다음 독자(사람, 주니어, 또는 당신의 맥락이 없는 에이전트)가 추측하는 것을 방지합니다.

한 쌍이 맞지 않을 때

이는 가장 가까운 태그를 선택하라는 신호가 아니라, 다시 살펴보라는 신호입니다.

  • 두 레이블이 모두 맞을 때, 리뷰어가 지금 수용할 수 있는 것과 연기할 수 있는 것을 명명하십시오. 이 두 결정이 다를 수 있고 유지되는 부분이 여전히 독립적으로 작동할 때 분할하십시오. 경로 또는 헝크(hunk)별로 스테이징하십시오(git add -p).
  • 유일한 호출자, 그 연결 및 필요한 거부 검사는 각각 고유한 약속이 없을 때 함께 유지하십시오. 커밋을 요점(point)으로 태그하고, 나머지는 따라옵니다.
  • gitmoji staged는 두 개의 범위를 보고합니다: 같은 질문을 하십시오. 변경 사항이 하나의 형태가 두 언어에 반영된 것처럼 전체로서만 의미가 있는 경우, 함께 유지하고 결정을 소유하는 패키지를 명명하십시오.
  • 주요 변경 사항에 의해 강제되는 부분은 따라옵니다: 그 유형, 테스트, 스토리, 잠금 파일.

각 커밋은 여전히 독립적으로 빌드되고 통과해야 합니다. 분할이 이를 깨뜨릴 경우, 강제된 부분을 함께 유지하고 본문에 그렇게 명시하십시오.

작성하기

  • 요약: 시스템이 지금 하는 일을 도메인의 언어로, 소문자 동사로 시작하십시오. 전체 첫 줄은 이모지, 티켓 및 범위를 포함하여 140자 이내여야 하며, 짧을수록 좋습니다. gitmoji check -m '<제목>'이 커밋 전에 문자 수를 계산해 줍니다. 파일 이름, 티켓 번호, "방법"은 넣지 마십시오.
  • 설명: 작성하는 모든 커밋에는 설명이 있어야 하며, 훅은 설명 없는 커밋을 거부합니다. 마커(🔖, 🔺), 자동화 작업의 커밋 및 git이 작성한 메시지만 설명이 필요 없습니다. 첫 줄 아래에 빈 줄, 그 다음 변경 이유: 이유, 왜 이 방법을 선택했는지(명백한 방법 대신), 또는 선택한 값. 한두 줄이면 보통 충분하며, 최대 여섯 줄입니다. 티켓 참조는 문장 내에 유지하십시오(예: "결정 사항은 #42 참조"). Git은 누군가 커밋을 편집할 때 #42로 시작하는 줄을 제거할 수 있습니다. diff를 다시 말하거나, 파일을 나열하거나, 당신의 프로세스를 설명하지 마십시오.
  • 이모지, 단축 코드가 아닙니다. 문자만 커밋됩니다.

작성자에 관하여

절대로 자신을 저자 또는 공동 저자로 추가하지 마십시오. Co-Authored-By: 줄, git config user.* 또는 --author에 에이전트 신원을 넣지 마십시오. 저자는 책임이 있는 사람이며, 훅은 에이전트를 거부합니다. 일부 도구는 요청 없이 공동 저자 줄을 추가합니다. 훅이 이 때문에 커밋을 거부하면, 해당 줄을 제거하고 다시 커밋하십시오.

대신, 본문을 빈 줄로 끝내고 커밋에 무엇이 들어갔는지 알리는 서명을 추가하십시오:

_
example-model (high), editor
Claude Code (example-session)
Sub-agents: 2 × example-helper (medium)
Team: reviewer, tester
Research: 3 searches, 12 pages

처음 세 줄은 항상 존재합니다. 마지막 세 줄은 해당되는 경우에만 나타납니다. 커밋이 이루어질 때, 훅은 밑줄을 △와 백틱 사이의 메시지가 검사된 용어집 버전으로 바꿉니다. 따라서 저장된 서명은 다음과 같습니다:

△ `1.2.3`
example-model (high), editor
Claude Code (example-session)

밑줄을 작성하십시오. △ 줄은 직접 작성하지 마십시오. 훅은 모든 메시지를 이 줄로 닫으며, 사람의 메시지도 마찬가지입니다. 사람의 메시지에는 그 한 줄만 있고 서명은 없습니다. gitmoji history는 이를 읽어 어떤 커밋이 어떤 버전에 있는지 알려줍니다.

프로젝트는 [rules] 아래에 signature = "agents"를 설정하여, 지원되는 에이전트 세션이 커밋 훅을 실행할 때 모델 및 하네스 줄을 요구할 수 있습니다. 사람은 일반 설명으로 커밋할 수 있습니다. 릴리스 마커 및 Git이 생성한 메시지는 기존 예외를 유지합니다.

줄의미
_서명이 여기서 시작됩니다. 훅이 이를 △ `<version>` 으로 바꿉니다.
model line모델과 그 노력 정도. 쉼표 뒤에, 당신의 이름(사람이 당신에게 이름을 부여한 경우에만).
harness line하네스와 (세션 ID가 있는 경우) 괄호 안의 세션 ID.
Sub-agents:이 커밋의 일부 작업을 수행한 서브 에이전트의 수, 모델 및 노력 정도별로.
Team:이 커밋을 위해 메시지를 주고받은 다른 에이전트.
Research:이 커밋을 위한 웹 검색, 읽은 페이지 및 문서 조회.

이 중 어떤 것도 기억에서 작성하지 마십시오. 이 스킬 폴더의 scripts/에 있는 당신의 하네스용 스크립트를 실행하고 출력을 붙여넣으십시오. 경로는 이 파일이 있는 폴더를 기준으로 하며, 스킬이 설치된 위치에 관계없습니다:

python3 scripts/claude-code.py

Claude Code에서 해당 폴더는 ${CLAUDE_SKILL_DIR}입니다. 스크립트는 하네스 자체의 세션 기록을 읽습니다. 하네스에 스크립트가 없는 경우, scripts/README.md에 한 번 작업하여 추가하는 방법이 나와 있습니다. 기록을 찾을 수 없는 경우 스크립트는 unknown을 출력합니다. 저장소가 세션 ID와 같은 특정 줄을 생략하도록 요청할 수 있습니다. 저장소 자체의 지침이 이를 알려줍니다.

세션이 여러 작업 또는 저장소에 걸쳐 있는 경우, 선택적 활동 줄을 이 커밋과 대조하십시오. 이 커밋에 기여한 내용만 유지하십시오.

본문에 포함될 수 있는 줄

  • 🩹에는 Limitation: <의존성이 할 수 없는 것>이 필요합니다.
  • 📥에는 Source: <가져온 실행, 도구 또는 시스템>이 필요합니다.
  • 🏁 및 ⚰️는 결정한 사항을 명시합니다.
  • 🐛는 원인을 명명할 수 있습니다: Broken-by: <sha>.

Gitmoji 업그레이드 시

CLI, 스킬 및 용어집은 릴리스 번호를 공유합니다. 훅은 저장소 설정이 명령어가 말하는 버전과 다른 버전을 지정할 때 경고합니다. 사용자에게 알리고, 경고가 제공하는 주소에서 변경된 사항을 읽으십시오. 사용자가 새 버전을 원할 때, 설정의 [vocabulary] 아래에 설정하고 이것만 커밋하십시오. 버전은 백틱 사이에:

🔺 gitmoji `<version>`: <이 저장소에 대한 변경 사항>

사용자가 요청하지 않는 한 이미 공유된 히스토리를 다시 작성하지 마십시오. 이전 규칙으로 작성된 커밋은 그대로 둘 수 있습니다. gitmoji history --unmigrated는 오늘날 통과되지 않을 커밋을 보여줍니다. 핀을 변경한 후 gitmoji init을 실행하여 설치된 스킬 및 관리되는 워크플로를 새로 고치십시오.

풀 리퀘스트 병합 및 히스토리 업그레이드

PR 제목 워크플로를 활성화하고 기본 병합 메시지로 Pull request title and description을 선택하십시오. 사람이 제목을 작성하십시오. Gitmoji는 커밋이 변경됨에 따라 이모지 접두사를 유지 관리합니다. 제안된 메시지와 함께 Create a merge commit을 사용하십시오. GitHub는 작성된 커밋을 보존하고 통합 PR 번호를 추가합니다.

기존 히스토리의 경우, 업그레이드 가이드와 설치된 scripts/gitmoji-upgrade-history.py를 사용하십시오. 로컬 후보를 생성하기 전에 드라이 런을 검사하십시오. 링크에는 어떤 PR이 병합되었는지 증거가 필요합니다. 공유 브랜치 대체는 저장소 소유자의 별도 결정 사항입니다.

Git이 작성하는 메시지

병합은 어떤 제목이든 가질 수 있습니다. 훅은 보류 중인 병합 중에 Git의 메시지 파일을 보존하며, gitmoji history는 여러 부모로 저장된 병합을 인식합니다. 텍스트 전용 check -m은 제목만 가지고 작업합니다. 일반적인 Git 브랜치, 태그 및 커밋 병합 제목, GitHub 풀 리퀘스트 병합 제목, 번호가 매겨진 Merge #N 캡션, 인용된 Git revert 및 reapply 제목, 번호가 매겨진 Revert #N 및 Reapply #N 캡션(제목 포함), Git의 기본 스쿼시 로그 제목 및 자동 스쿼시 접두사 fixup! , squash! 및 amend! 를 인식합니다.

사용자 정의 PR 제목이 있는 스쿼시 병합은 일반적인 단일 부모 커밋을 생성합니다. 체리픽 및 리베이스는 일반 제목을 전달할 수도 있습니다. 다른 작성된 커밋과 마찬가지로 이를 확인하십시오. PR 번호만으로는 병합을 식별하지 못합니다.

도입 중에 프로젝트는 gitmoji.toml의 [rules] → untagged = "warn"을 설정하여 일반 제목을 수용하고 검토를 위해 플래그를 지정할 수 있습니다. 기본값은 "error"입니다. "off"를 사용하면 태그 누락이 조용히 수용됩니다. 다른 검사는 계속 적용됩니다. 브랜치에서 gitmoji history trunk..HEAD를 사용하여 공유 전에 다시 작성해야 할 제목을 찾으십시오. 히스토리는 항상 태그가 없는 제목을 엄격하게 검사합니다.

아무것도 맞지 않을 때

항목을 억지로 맞추지 마십시오. 가장 가까운 정직한 항목을 사용하고, 본문 줄 Miss: <말하고 싶었던 것>을 추가한 후 사용자에게 알리십시오. Miss는 용어집이 개선되는 방식입니다.

관련 스킬