Communitygithub.com

커밋 스킬

관례적 커밋 스타일과 원자적 커밋 원칙에 따라 변경 사항을 스테이징하고 커밋합니다.

커밋 스킬란 무엇인가요?

이 스킬은 Claude가 Git 저장소에서 변경 사항을 스테이징하고 커밋할 때 일관된 관례적 커밋 메시지 형식, 적절한 범위 지정, 그리고 원자적 커밋 원칙을 따르도록 도와줍니다. 사용자가 '커밋', '커밋 메시지 작성', '작업 저장' 등을 요청하거나, Claude가 변경 사항을 스테이징하고 커밋해야 할 때 자동으로 활성화됩니다. 이 스킬은 `git status`, `git diff`, `git log --oneline -10` 명령어로 변경 사항과 최근 커밋 기록을 검토한 후, lint, 테스트 등 CI 검사를 먼저 실행하고, 특정 파일만 선택적으로 스테이징하며(`git add file1 file2`), 허용된 타입(feat, fix, refactor, style, docs, test, chore, perf, ci)과 선택적 범위를 포함한 관례적 형식의 커밋 메시지를 생성합니다. 또한 비밀, 빌드 산출물, 생성된 파일이 커밋되지 않도록 경고하며, `--no-verify` 플래그 사용을 금지하고, 필요시 공동 작성자 정보를 추가합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/commit

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

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

문서

커밋 스킬은(는) 무엇을 하나요?

관례적 커밋 스타일과 원자적 커밋 원칙에 따라 변경 사항을 스테이징하고 커밋합니다.

커밋 메시지 형식

<타입>(<선택적 범위>): <짧은 요약>
  • 소문자로만 작성 — 타입, 범위, 요약 모두
  • 요약 끝에 마침표 없음
  • 명령형 사용 — "added feature"나 "adds feature" 대신 "add feature"
  • 요약 줄은 최대 50자 (권장 한도, hard limit 72자)
  • 요약은 무엇이 아닌 왜를 설명 (diff가 무엇을 보여줌)

타입

타입사용 시기예시
feat새로운 기능이나 능력feat: add user authentication flow
fix버그 수정fix: resolve null pointer on empty input
refactor버그 수정이나 기능 추가 없는 코드 변경refactor: extract parser into standalone module
style포맷팅, 공백, 세미콜론 — 로직 변경 없음style: apply formatter to config files
docs문서만 변경docs: add API usage examples to readme
test테스트 추가나 업데이트test: add edge case coverage for validator
chore빌드 프로세스, 도구, 의존성, 설정chore: update dependency lockfile
perf성능 개선perf: cache repeated database lookups
ciCI/CD 파이프라인 변경ci: add lint step to PR workflow

범위 (선택 사항)

타입만으로는 모호할 때 범위를 사용해 컨텍스트를 좁힙니다. 프로젝트의 디렉토리 구조나 도메인 영역에서 범위를 도출하세요:

feat(auth): add OAuth2 token refresh
fix(api): handle timeout on large payloads
docs(contributing): add setup instructions

워크플로우

  1. 변경 사항 검토 — git status와 git diff (스테이징 + 언스테이징)를 실행하여 무엇이 변경되었는지 확인
  2. 최근 히스토리 확인 — git log --oneline -10을 실행하여 프로젝트의 기존 커밋 스타일과 일치하는지 확인
  3. 의도 확인 — 변경 사항이 하나의 논리적 단위인지 확인; 그렇지 않으면 여러 커밋으로 나누도록 제안
  4. CI 검사 실행 — 스테이징 전에 프로젝트의 linter, formatter, 테스트 스위트를 실행하여 문제를 조기에 발견. package.json 스크립트, Makefile, 또는 CI 설정에서 사용 가능한 명령어 확인. 실패 시 수정 후 진행.
  5. 파일 스테이징 — 특정 파일을 이름으로 추가 (git add file1 file2), 절대 git add -A나 git add . 사용 금지
  6. 메시지 작성 — 올바른 타입 선택, 필요시 범위 추가, 명령형 요약 작성
  7. 커밋 — 메시지에 heredoc을 사용하여 깔끔한 서식 유지
  8. 확인 — 커밋 후 git status 실행하여 성공 여부 확인

멀티라인 커밋

본문이 필요한 커밋의 경우 (드물게 — 간결한 한 줄 메시지 선호):

<타입>(<범위>): <요약>

<본문: 무엇이 아닌 왜를 설명>
  • 요약과 본문 사이에 빈 줄
  • 본문은 72자에서 줄바꿈
  • 요약만으로 이유를 전달할 수 없을 때만 본문 사용

규칙

  • 원자적 커밋 — 커밋당 하나의 논리적 변경. 기능과 그 테스트는 하나의 커밋이 될 수 있음. 관련 없는 서식 수정은 별도 커밋으로.
  • 비밀 정보 금지 — 절대 .env, 자격 증명, API 키, 토큰을 커밋하지 않음. 이러한 파일이 스테이징되면 사용자에게 경고.
  • 생성된 산출물 금지 — 빌드 출력, 의존성 디렉토리, 컴파일된 파일을 커밋하지 않음. 스테이징 전에 .gitignore 적용 범위 확인.
  • 새 커밋만 생성 — 항상 새 커밋 생성. 사용자가 명시적으로 요청하지 않는 한 절대 amend하지 않음.
  • 훅 건너뛰기 금지 — 절대 --no-verify 사용 금지. 훅이 실패하면 근본 문제 해결.
  • 공동 작성자 줄 — Claude가 변경 사항을 작성하거나 공동 작성한 경우 공동 작성자 트레일러 추가:
Co-Authored-By: Claude <[email protected]>

예시

# Feature — 새로운 기능
feat: add webhook notification system

# Feature with scope
feat(api): add rate limiting middleware

# Fix — 버그 수정
fix: prevent crash on malformed JSON input

# Style — 서식만
style: apply consistent indentation across modules

# Docs — 문서
docs: add architecture decision records

# Chore — 도구/설정
chore: broaden gitignore to cover build artifacts

# Test with scope
test(auth): add integration tests for token refresh

# Refactor with scope
refactor(db): replace raw queries with query builder

참조 문서

  • conventional-commits.md — 타입 선택 가이드, breaking changes, 범위 전략, 멀티 파일 커밋 결정, 본문 서식, 트레일러, 일반적인 실수

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

관련 스킬