Когда это нужноWhen to reach for itКоли це потрібно
Куча изменённых и неотслеживаемых файлов без понятного разбиения на коммиты, сомнение, на какой вы ветке и что нельзя включать в коммит, или нужна старая версия файла.A pile of modified and untracked files with no clear split into commits, doubt about which branch you are on or what must stay out of the commit, or a need to see an older version of a file.Купа змінених і невідстежуваних файлів без зрозумілого розбиття на коміти, сумнів, на якій ви гілці й що не можна включати до коміту, або потрібна стара версія файлу.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Читает файлы проектаReads the files of your projectЧитає файли проєкту
- Запускает команды (проверки, git)Runs commands (checks, git)Запускає команди (перевірки, git)
- Работает сWorks withПрацює з
- Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
- Где выполняются шагиWhere the steps happenДе виконуються кроки
- Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
- Где это лежит в kitWhere it lives in the kitДе це лежить у kit
.claude/skills/git/SKILL.md
Агент не выполняет git commit, git push и переписывание истории, пока вы об этом не попросили, а на защищённой или основной ветке сначала создаёт новую ветку. Индекс, группировку и diff он делает сам и останавливается лишь перед необратимыми действиями или правкой общей истории. Восстановление файла из старого коммита через git checkout перезаписывает рабочую копию.The agent does not run git commit, git push or a history rewrite unless you asked for it, and on a protected or default branch it branches first. It stages, groups and diffs on its own and stops only before irreversible or shared-history operations. Restoring a file from an old commit with git checkout overwrites your working copy.Агент не виконує git commit, git push і переписування історії, доки ви про це не попросили, а на захищеній або основній гілці спершу створює окрему гілку. Індекс, групування й diff він робить сам і зупиняється лише перед незворотними операціями та операціями над спільною історією. Відновлення файлу зі старого коміту через git checkout перезаписує вашу робочу копію.
ШагиStepsКроки
- Задайте вопрос или назовите действие:
/git analyze current changes and suggest commit groups,/git what should I commit now?или/git show me the old version ofи имя файла. Просто/gitвыводит полный справочник.Ask a question or name an action:/git analyze current changes and suggest commit groups,/git what should I commit now?, or/git show me the old version offollowed by a file name. A bare/gitprints the full reference.Поставте запитання або назвіть дію:/git analyze current changes and suggest commit groups,/git what should I commit now?або/git show me the old version ofта ім'я файлу. Просто/gitвиводить повний довідник. - Для анализа агент запускает
git status, чтобы увидеть все изменённые и неотслеживаемые файлы, а затемgit branch --show-current, чтобы подтвердить активную ветку.For the analysis, the agent runsgit statusto list everything modified and untracked, thengit branch --show-currentto confirm the active branch.Для аналізу агент запускаєgit status, щоб побачити всі змінені й невідстежувані файли, а потімgit branch --show-current, щоб підтвердити активну гілку. - Он группирует файлы по функции или теме. Типичное разбиение: изменение в коде вместе с файлом спеки или плана, затем документация и changelog, затем инфраструктура: конфигурация сборки, зависимости, настройки. Одна тема - один коммит.It groups the files by feature or concern. A typical split: the source change together with its spec or plan file, then docs and changelog, then infrastructure such as build config, dependencies and settings. One concern goes into one commit.Він групує файли за функцією або темою. Типовий поділ: зміна в коді разом із файлом спеки чи плану, потім документація й changelog, потім інфраструктура: конфігурація збірки, залежності, налаштування. Одна тема - один коміт.
- Он выделяет файлы, которые коммитить не нужно: результат сборки, кэши, локальное окружение и секреты, конфигурацию конкретной машины, сгенерированные или автоиндексируемые файлы, большие бинарники и всё, что лежит в вашей scratch-папке. При сомнении он смотрит
.gitignoreи спрашивает, прежде чем добавлять бинарник или файл конфигурации.It picks out the files that should not be committed: build output, caches, local env and secrets, machine-specific config, generated or auto-indexed files, large binaries and anything under your scratch directory. When in doubt it checks.gitignoreand asks before adding a binary or a config file.Він виділяє файли, які комітити не треба: результат збирання, кеші, локальне середовище й секрети, конфігурацію конкретної машини, згенеровані або автоіндексовані файли, великі бінарники та все, що лежить у вашій scratch-теці. У разі сумніву він дивиться.gitignoreі питає, перш ніж додавати бінарник або файл конфігурації. - Он предлагает от 2 до 4 логичных групп коммитов, у каждой своё сообщение с префиксом Conventional Commits:
feat,fix,refactor,perf,docs,chore,test,build,ci,styleилиrevert. Если причина неочевидна, сообщение объясняет, зачем это сделано.It suggests 2 to 4 logical commit groups, each with a proposed message under a Conventional Commits prefix:feat,fix,refactor,perf,docs,chore,test,build,ci,styleorrevert. The message explains the why when it is not obvious.Він пропонує від 2 до 4 логічних груп комітів, у кожної своє повідомлення з префіксом Conventional Commits:feat,fix,refactor,perf,docs,chore,test,build,ci,styleабоrevert. Якщо причина неочевидна, повідомлення пояснює, навіщо це зроблено. - Заголовок называет видимое пользователю изменение, а не механизм:
fix: keep page breaks in PDF invoices, а неfix: flush stream before close. Указание авторства, например строка соавтора или трейлер инструмента, - выбор команды, который фиксирует файл правил проекта, и агент ему следует. Если файл молчит, агент спрашивает один раз, записывает ваш ответ в файл правил и следует ему. Авторство он никогда не добавляет и не убирает молча.A subject names the user-visible change, not the mechanism:fix: keep page breaks in PDF invoices, notfix: flush stream before close. Attribution, such as a co-author line or a tool trailer, is a team choice that the project's rules file states, and the agent follows it. If the file says nothing, it asks once, writes your answer into the rules file and follows it. It never adds or strips attribution silently.Заголовок називає видиму користувачеві зміну, а не механізм:fix: keep page breaks in PDF invoices, а неfix: flush stream before close. Зазначення авторства, наприклад рядок співавтора чи трейлер інструмента, - вибір команди, який фіксує файл правил проєкту, і агент його дотримується. Якщо файл мовчить, агент питає один раз, записує вашу відповідь у файл правил і дотримується її. Авторство він ніколи не додає й не прибирає мовчки. - Для каждой группы он показывает точные команды
git add. Перед коммитом проверьте, что попало в индекс, командойgit diff --cached.It shows the exactgit addcommands for each group. Before you commit, check what is staged withgit diff --cached.Для кожної групи він показує точні командиgit add. Перед комітом перевірте, що потрапило до індексу, командоюgit diff --cached.
План, по которому можно действовать: подтверждённая активная ветка, названные файлы, которые нужно оставить за рамками коммита, и от 2 до 4 групп коммитов с сообщениями и командами git add. История не меняется, пока вы сами не закоммитите или не попросите об этом агента.A plan you can act on: the active branch confirmed, the files to leave out named, and 2 to 4 commit groups with messages and git add commands. The history stays unchanged until you commit or ask the agent to.План, за яким можна діяти: підтверджена активна гілка, названі файли, які слід залишити поза комітом, і від 2 до 4 груп комітів із повідомленнями та командами git add. Історія не змінюється, доки ви самі не закомітите або не попросите про це агента.
СоветыTipsПоради
- Модель веток в справочнике - лишь вариант по умолчанию:
mainостаётся стабильной для релизов и принимает слияния из рабочих веток (feat/x,fix/xили последовательныеdev-vNNN), а число живых рабочих веток невелико. Замените её своим процессом; kit настаивает только на одном: перед коммитом вы знаете, на какой вы ветке.The branching model in the reference is only a default:mainstays release-stable and takes merges from work branches (feat/x,fix/xor sequentialdev-vNNN), and the number of live work branches stays small. Replace it with your team's flow; the kit insists only that you know which branch you are on before you commit.Модель гілок у довіднику - лише варіант за замовчуванням:mainлишається стабільною для релізів і приймає злиття з робочих гілок (feat/x,fix/xабо послідовніdev-vNNN), а кількість живих робочих гілок невелика. Замініть її своїм процесом; kit наполягає лише на одному: перед комітом ви знаєте, на якій ви гілці. - Для вопросов об истории справочник перечисляет
git show HASH:path/to/fileдля файла в том виде, как он был в коммите,git log --oneline -- path/to/file,git blameиgit diffмежду двумя коммитами.For history questions the reference listsgit show HASH:path/to/filefor a file as it was at a commit,git log --oneline -- path/to/file,git blameand agit diffbetween two commits.Для питань про історію довідник перелічуєgit show HASH:path/to/fileдля файлу в тому вигляді, як він був у коміті,git log --oneline -- path/to/file,git blameіgit diffміж двома комітами. - Если вы выпускаете релизы, три правила действуют при любом процессе: зафиксируйте версию один раз и проставьте её во все артефакты, выводите заметки о релизе из поддерживаемого списка видимых пользователю изменений, а не из сырого журнала коммитов, и держите путь релиза одной задачи, который переносит только её коммиты.If you ship, three invariants hold in any flow: pin the version once and stamp it into every artifact, derive release notes from a maintained list of user-visible changes rather than the raw commit log, and keep a single-ticket release path that cherry-picks only that ticket's commits.Якщо ви випускаєте релізи, три правила діють за будь-якого процесу: зафіксуйте версію один раз і проставте її в усі артефакти, виводьте нотатки до релізу з підтримуваного списку видимих користувачеві змін, а не з сирого журналу комітів, і майте шлях релізу однієї задачі, що переносить лише її коміти.
.claude/settings.jsonиз kit (только Claude Code) разрешаетgit add,git commit,git switch,git branchиgit fetchбез запроса, спрашивает передgit pushиgit rebaseи запрещает принудительный push,git reset --hardиgit clean. Это убирает запросы, но не собственное правило агента: ни коммита, ни push без вашей просьбы. Правило запрета - не граница безопасности.The kit's.claude/settings.json(Claude Code only) letsgit add,git commit,git switch,git branchandgit fetchrun without a prompt, asks beforegit pushandgit rebase, and denies force push,git reset --hardandgit clean. That removes prompts, not the agent's own rule: no commit or push without your request. A deny rule is not a security boundary..claude/settings.jsonіз kit (лише Claude Code) дозволяєgit add,git commit,git switch,git branchіgit fetchбез запиту, питає передgit pushтаgit rebaseі забороняє примусовий push,git reset --hardтаgit clean. Це прибирає запити, але не власне правило агента: ні коміту, ні push без вашого прохання. Правило заборони - не межа безпеки.
Связанные функцииRelated functionsПов'язані функції
- Получить краткое сообщение коммита для вставкиGet a terse Conventional Commit message to pasteОтримати стисле повідомлення коміту для вставки
/caveman-commitпишет краткое сообщение коммита в формате Conventional Commits по вашему описанию или diff, блоком для вставки.git commitон не запускает./caveman-commitwrites a terse Conventional Commit message from your description or the current diff, as a code block to paste. It never runsgit commit./caveman-commitпише стисле повідомлення коміту у форматі Conventional Commits за вашим описом або поточним diff, блоком коду для вставки.git commitвін не запускає. - Провести ревью изменения и получить замечания по серьёзностиCritique a change and get findings by severityПровести рев'ю зміни й отримати зауваження за серйозністюСжатое ревью diff, документа, набора данных или договора: сначала замечания, самые серьёзные выше, у каждого место и конкретная правка.A terse review of a diff, a document, a dataset or a contract: findings first, highest severity on top, each with a place and a concrete fix.Стисле рев'ю diff, документа, набору даних чи договору: спершу зауваження, найсерйозніші вгорі, у кожного місце й конкретна правка.
- Провести тикет по жизненному циклу с проверкой на каждом шагеMove a ticket through the lifecycle with a gate at every stepПровести тікет життєвим циклом із перевіркою на кожному кроціТикет - это один Markdown-файл со строкой статуса. Каждый навык требует входной статус и выдаёт выходной, поэтому этап нельзя пропустить на глаз.A ticket is one Markdown file with a status line. Each skill requires an entry status and produces an exit status, so no stage is skipped on a hunch.Тікет - це один Markdown-файл із рядком статусу. Кожна навичка вимагає вхідний статус і видає вихідний, тож етап не можна пропустити на око.