git-workflow

Doyajin174's avatarfrom Doyajin174

Complete Git workflow from conventional commits to pre-completion verification. Use for all Git operations including commits, branches, and releases.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the end-to-end Git workflow, ensuring high code quality through standardized Conventional Commits and rigorous pre-completion verification. It streamlines version control by integrating automated testing, linting, and type-checking directly into the agent's development process, preventing common errors and maintaining repository integrity.

Use Cases

  • Standardizing Commit History: Automatically format commit messages using the Conventional Commits specification (feat, fix, refactor) to ensure a clean, searchable, and professional project history.
  • Automated Quality Assurance: Execute a comprehensive verification suite—including unit tests, ESLint, and TypeScript type-checking—to validate code before any commit or push.
  • Branch Strategy Management: Implement and maintain structured branching naming conventions (feature/, fix/, refactor/) to improve team collaboration and release organization.
  • Pre-Completion Checklists: Use a systematic verification process to ensure builds succeed, unnecessary logs are removed, and all changes are properly staged before finalizing tasks.
namegit-workflow
descriptionComplete Git workflow from conventional commits to pre-completion verification. Use for all Git operations including commits, branches, and releases.
allowed-toolsRead, Glob, Grep, Edit, Write, Bash
licenseMIT
authorantigravity-team
version"2.0"

Git Workflow

커밋부터 완료 검증까지의 Git 워크플로우 통합 스킬입니다.

Conventional Commits

Format

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

[optional body]

[optional footer]

Types

Type 설명 예시
feat 새 기능 feat(auth): add JWT login
fix 버그 수정 fix(api): handle null response
refactor 리팩토링 refactor(utils): simplify parser
docs 문서 docs: update README
test 테스트 test(auth): add login tests
chore 기타 chore: update deps

Breaking Changes

feat(api)!: change response format

BREAKING CHANGE: response.data is now response.result

Pre-Completion Verification

완료 선언 전 필수 체크

# 1. 테스트 통과
npm test

# 2. 린트 통과
npm run lint

# 3. 타입 체크 (TypeScript)
npx tsc --noEmit

# 4. 빌드 성공
npm run build

Verification Checklist

  • 모든 테스트 통과
  • 린트 에러 없음
  • 타입 에러 없음
  • 빌드 성공
  • 변경사항 커밋됨
  • 불필요한 console.log 제거

Branch Strategy

main ─────────────────────────────
  │
  └─ feature/auth ───○───○───○─┐
                               │
                               └─ merge

Naming

feature/<description>
fix/<issue-number>-<description>
refactor/<description>

Commit Workflow

# 1. 변경사항 스테이징
git add <files>

# 2. 커밋 (규격 준수)
git commit -m "feat(scope): description"

# 3. 푸시 전 검증
npm test && npm run lint

# 4. 푸시
git push

Checklist

  • 커밋 메시지 규격 준수
  • 테스트 통과
  • 린트 통과
  • 빌드 성공