Communitygithub.com

josepdecid/자막-플래시카드

Conventional Commits 사양에 따라 Git 커밋을 생성하고, 선택적으로 푸시합니다. 사용자가 변경 사항을 커밋하거나 /commit을 실행할 때 사용합니다.

자막-플래시카드란 무엇인가요?

이 스킬은 Git 저장소에서 커밋을 생성할 때 Conventional Commits 포맷을 자동으로 적용하여 일관된 커밋 메시지를 유지하도록 돕습니다. 사용자가 변경 사항을 커밋하거나 `/commit` 명령을 실행하면, 스테이징되지 않은 파일 중 관련된 변경 사항을 파악하고, 적절한 타입(feat, fix, docs 등)과 범위(scope)를 지정하여 메시지를 작성한 후 커밋합니다. 불필요한 파일(.env, secrets, .venv)은 스테이징에서 제외하며, 관련 없는 변경 사항은 별도의 커밋으로 분리합니다. `--push` 플래그가 전달된 경우에만 원격 저장소로 푸시하며, 강제 푸시는 절대 수행하지 않습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josepdecid/subtitle-flashcards/tree/HEAD/.agents/skills/conventional-commit

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

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

문서

워크플로우

  1. 저장소 상태 확인: git status --short, git diff --cached, git diff. 또한 git log --oneline -10을 확인하여 기존 스타일과 일치시킵니다.
  2. 스테이징된 항목이 없으면, 명시적 경로로 관련 변경 사항을 스테이징합니다(git add -A는 관련 없거나 민감한 파일이 있을 경우 피합니다). .env, secrets, .venv는 절대 스테이징하지 마세요.
  3. 변경 사항에 명백히 관련 없는 내용이 포함된 경우, 별도의 커밋으로 분리합니다.
  4. 아래 형식에 따라 메시지를 작성한 후 git commit으로 커밋합니다.
  5. git status를 실행하여 커밋이 성공했는지 확인합니다.
  6. 사용자가 --push를 전달한 경우에만 푸시합니다: git push 실행 (업스트림이 설정되지 않은 경우 git push -u origin <branch> 사용). 강제 푸시는 절대 하지 마세요.

메시지 형식

<type>(<optional scope>): <description>

<optional body>

<optional footer>
  • 타입: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
  • 설명: 명령형, 소문자, 마침표 없음, 최대 약 72자.
  • 범위: 영향을 받는 영역을 나타내는 짧은 명사(예: cli, server, translate); 모호하면 생략.
  • 본문: 이유를 설명하며, 약 72자로 줄바꿈; 사소한 변경 사항은 생략.
  • 주요 변경 사항: 타입/범위 뒤에 !를 추가하고 BREAKING CHANGE: 푸터를 포함.

규칙

  • 요청하지 않는 한 수정, 리베이스, 또는 히스토리 재작성을 하지 마세요.
  • 훅을 건너뛰지 마세요(--no-verify).
  • 훅이 실패하면 문제를 해결하고 새 커밋을 만드세요.
  • 변경 사항이 없으면 커밋하지 말고 그렇다고 알리세요.

관련 스킬