Atomic Commit — скилл для Claude Code: что делает и как установить
Скилл Atomic Commit разбирает рабочую копию Git на изолированные атомарные коммиты с проверкой тестов и сборки перед каждой фиксацией.
MIT 5 установок ★ 84 обновлён 2025-11-21
npx skills add chanwit/tdg --skill atomic-commit -a claude-codeЧто делает Atomic Commit
Скилл анализирует вывод git status, git diff и git diff --staged, чтобы выявить смешанные изменения. Он находит случаи, когда в одном наборе файлов перемешаны разные фичи, правка багов с рефакторингом или тесты для нескольких несвязанных модулей. Перед фиксацией агент группирует файлы по целям и запрашивает подтверждение.
Команда git add . здесь запрещена регламентом. Для каждой группы агент индексирует только нужные файлы через git add <file>, проверяет диффы, запускает тесты со сборкой и оформляет сообщение в формате Conventional Commits (feat, fix, refactor, docs, test, chore, perf, style). Если в ветке или запросе указан номер задачи, он добавляет его к тексту коммита, а при отсутствии может предложить создать issue через gh или glab.
Скилл прямо рассчитан на классическую разработку без TDD. Для TDD-процессов автор советует другой скилл из того же репозитория — TDG.
Какие задачи решает
- разбить большой несохранённый дифф на независимые коммиты
- отделить рефакторинг и правку багов от нового кода
- привязать номера задач GitHub или GitLab к сообщениям коммитов
- прогнать тесты и сборку отдельно для каждой пачки файлов
Примеры запросов агенту
- Разбей текущие изменения на atomic commits
- Сделай clean commits из накопившегося диффа
- Split commits: отдели тесты и фиксы от новой функциональности
Как установить Atomic Commit
1Через Skills CLI (Vercel)
npx skills add chanwit/tdg --skill atomic-commit -a claude-code2Вручную: положить файлы
~/.claude/skills/atomic/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/atomic/
1Через Skills CLI (Vercel)
npx skills add chanwit/tdg --skill atomic-commit -a codex2Вручную: положить файлы
.agents/skills/atomic/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add chanwit/tdg --skill atomic-commit -a cursor2Вручную: положить файлы
.cursor/skills/atomic/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install chanwit/tdg skills/atomic2Вручную: положить файлы
.github/skills/atomic/SKILL.md1Через Skills CLI (Vercel)
npx skills add chanwit/tdg --skill atomic-commit -a gemini-cli2Командой платформы
gemini skills install https://github.com/chanwit/tdg --path skills/atomicВручную: положить файлы
.devin/skills/atomic/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add chanwit/tdg --skill atomic-commit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об Atomic Commit
Как установить Atomic Commit в Claude Code?
Выполните в терминале команду npx skills add chanwit/tdg --skill atomic -a claude-code. Файл скилла разместится по пути ~/.claude/skills/atomic/SKILL.md.
Что делает скилл Atomic Commit?
Он анализирует изменённые файлы, находит логически несвязанные правки, предлагает пользователю план группировки и по очереди создаёт коммиты с обязательным запуском тестов.
Подходит ли этот скилл для TDD-разработки?
Нет, он предназначен только для не-TDD процессов. Если разработка ведётся через тесты, автор рекомендует использовать специализированный скилл TDG.
Исходный текст
SKILL.md · MIT
--- name: Atomic Commit description: Atomic Commit helps create clean, atomic commits by analyzing changes, detecting mixed concerns, and ensuring each commit is a complete unit of work. Key words to detect are atomic, atomic commits, clean commits. --- # Atomic Commit Standalone skill for non-TDD workflows. Helps create clean, atomic commits by analyzing changes and detecting mixed concerns. ## Atomic Commit Definition - Does exactly one thing (one feature/fix/refactor) - Leaves codebase in working state (builds and tests pass) - Can be reverted independently - Doesn't mix unrelated concerns ## Workflow ### 1. Analyze Changes ```bash git status && git diff && git diff --staged ``` ### 2. Detect Mixed Concerns Look for files mixing: - Multiple features - Bug fixes + features - Refactoring + new functionality - Multiple unrelated bug fixes - Code + documentation (unless for same feature) - Tests for multiple features ### 3. Group Commits Group files by shared purpose. Present grouping to user for confirmation. Example: ``` Group 1: "Add user auth" → auth/login.ts, auth/session.ts, tests/auth/login.test.ts Group 2: "Fix password validation" → validators/password.ts, tests/validators/password.test.ts ``` ### 4. Create Each Commit For each group: 1. Stage: `git add <file1> <file2>` (NO `git add .`) 2. Review: `git diff --staged` 3. Test: Run tests, ensure pass 4. Build: Run build if applicable, ensure success 5. Commit: Use conventional commit format 6. Verify: `git log -1 --oneline` Conventional commit types: `feat|fix|refactor|docs|test|chore|perf|style` ### 5. Final Check ```bash git log --oneline -n <N> ``` ## Issue Integration - Check user message or branch name for issue number - IF no issue: ask if user wants to create one - IF user does not want to provider, leave it blank - IF yes: help write description, offer `gh issue create` or `glab issue create` - Include in commits: `"feat: description (#42)"` ## Guidelines **DO:** One logical change, include related tests, run tests, clear messages, issue numbers **DON'T:** Mix features/fixes/refactors, commit broken code, vague messages, debug code ## TODO Pattern ☐ Analyze: git status/diff ☐ Identify file purposes ☐ Detect mixed concerns ☐ Group into atomic commits ☐ Confirm with user ☐ For each: stage → review → test → build → commit → verify ☐ Final review ## Activation Use when user says: "atomic", "clean commits", "break down commits", "split commits" DO NOT use for TDD workflows (use TDG skill). ## Closing "Created N atomic commits. Tests pass. Would you like to review history, push, or create PR?"
© chanwit · MIT · chanwit/tdg