Skip to content

bestdeejay-design/agent-skills / skills/commit-message-writer

commit-message-writer

Unverified

Используй, когда нужно оформить staged-изменения в Conventional Commit. Генерация Conventional Commits-сообщений на основе git diff --staged: тип по изменённым файлам, scope по путям, краткое описание, опциональный body с переносами. Триггеры: 'commit message', 'write commit', 'git commit', 'conventional commit', 'сообщение коммита', 'написать коммит', 'commit', 'закоммитить'.

Commit Message Writer

Conventional Commits из вашего staged-diff за один шаг.

Загружай этот скилл когда нужно написать сообщение коммита по уже застейдженным изменениям (git add уже сделан). Скилл анализирует diff, определяет тип и scope, выдаёт готовое сообщение в формате Conventional Commits.

When to use

Use this skill when:

  • Изменения уже застейджены (git add), нужно сообщение коммита
  • Нужно привести формат к Conventional Commits (CI требует commitlint)
  • Нужно автоматически определить scope по путям файлов
  • Нужен короткий заголовок + тезисный body (если diff большой)

Do NOT use when:

  • Изменения ещё не застейджены — сначала git add или git add -p
  • Требуется разбить изменения на несколько логических коммитов — сначала разбей, потом вызывай скилл для каждой части
  • Это squash/rebase/merge коммит — скажи об этом явно

What this skill does

Inputs

  • staged (default): анализирует git diff --cached (только staged)
  • --unstaged (опция): аналогично для unstaged (не рекомендуется)
  • --scope (опция): принудительный scope вместо автодетекта
  • --emoji (опция): добавить gitmoji-префикс перед типом (✨ feat: ...)

Outputs

  • Готовое сообщение коммита (1 строка заголовок + опциональный body), копируемое командой git commit или в файл COMMIT_EDITMSG.
  • Краткая справка: тип, scope, почему выбран именно этот тип.

How to use

Шаг 1: убедись, что изменения застейджены

git add <file1> <file2>
git diff --cached --stat   # проверить, что видит скилл

Шаг 2: сгенерировать сообщение

python3 scripts/suggest.py --cached

Пример вывода:

✨ feat(api): add GET /v1/health endpoint with liveness probe

- expose /v1/health via Fastify (src/routes/health.ts)
- add HealthService with process uptime + memory gauge
- wire route into router bootstrap (src/app.ts)

Type: feat — new endpoint, backwards-compatible addition
Scope: api — paths match src/api/** or src/routes/**

Шаг 3: закоммитить

git commit -m "$(python3 scripts/suggest.py --c)"

(или скопируйте сообщение в git commit вручную).

Examples

Example 1: новая фича

Input: staged src/routes/health.ts, src/index.ts Output:

feat(health): add /v1/health liveness endpoint

- add GET /v1/health (liveness probe)
- register route in server bootstrap

Example 2: исправление

Input: staged fix в src/util/parser.ts Output:

fix(parser): handle empty input instead of throwing

Return empty result set when input is blank; add regression test.

Example 3: документация

Input: staged README.md, docs/architecture.md Output:

docs: clarify onboarding flow in README and architecture

Constraints & gotchas

  • Aнализ только staged: скрипт не коммичит сам — только выдаёт сообщение.
  • Один логический коммит: если изменения разнородные (feat + fix + docs в одном diff), скрипт выберет доминирующий тип и пометит в «краткой справке», что стоит разбить на несколько коммитов.
  • Breaking changes: если diff содержит BREAKING CHANGE или удаление публичного API (например - в функциях), скрипт добавит ! к типу (feat!) и блок BREAKING CHANGE: в body.
  • Не использует эмодзи по умолчанию: gitmoji включается только флагом --emoji.
  • Скроб-крайние случаи: для merge/revert коммитов предложение не даётся — используйте дефолт git merge/git revert.

Related

  • Pairs well with code-review (ревью до коммита) и changelog-generator (после — из коммитов в CHANGELOG).
  • Convention spec: https://www.conventionalcommits.org/ — правила типов.
  • Линтер для CI: https://commitlint.js.org/ (если проекте используется).

Boundaries

  • Do not use to validate existing history; use commit-lint.

Evidence and completion gate

Run the documented command against the user’s actual input. Report the command, exit status, files changed or produced, and relevant stdout/stderr. Separate blocked or pre-existing failures from failures introduced by the current work. Do not call the result complete when the script was only described or when an artifact was not reopened and checked.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall