oma-scm · first-fluke — скилл для Claude Code и Codex: управление Git-историей
Скилл oma-scm для Claude Code выполняет Git-операции: коммиты, ветки, слияния и разрешение конфликтов. Он задаёт явную область действий и предусматривает возможность отката.
MIT ★ 1 472 обновлён 2026-10-29
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает oma-scm
Скилл oma-scm из репозитория oh-my-agent учит агента выполнять Git-операции с явной областью действия, отслеживаемыми коммитами и возможностью отката. Он покрывает коммиты, staging, push, ветки, merge, rebase, разрешение конфликтов, worktrees и проверку SCM-политик.
Внутри скилла — пошаговый процесс: сначала осмотр рабочего дерева через git status -sb, git diff, git log --oneline -5, затем выбор логических групп изменений, коммит с подготовленным сообщением и проверка результата. Для сложных случаев есть отдельные ресурсы: resources/merge-risk.md для крупных слияний, resources/cm-operations.md для governance и релизов, resources/conventional-commits.md для синтаксиса сообщений.
Есть жёсткие ограничения: без явного разрешения агент не делает git add -A, не переписывает общую историю и не пушит в default-ветку напрямую, если в конфиге включён scm.require_pr_for_default_branch. Для force-push используется только --force-with-lease. Если хук отклоняет сообщение — скилл чинит проблему, а не обходит её. Нужен Git CLI и проектная конфигурация с хуками. Скилл не пишет фичи и не исправляет код — для этого есть другие специалисты в экосистеме.
Какие задачи решает
- разбить изменения на логические коммиты по фичам
- подготовить Conventional Commit сообщение и назвать ветку
- разрешить конфликт слияния, сохранив оба намерения
- проверить staged-дифф перед amend и не зацепить чужое
- провести крупный merge без потери истории и с планом отката
Примеры запросов агенту
- Закоммить изменения в
src/api.tsиtests/api.test.tsодним коммитом по Conventional Commits - Создай ветку
fix/login-timeoutи открой PR вместо прямого пуша в main - Разреши конфликт в
package-lock.json, сохрани обе версии зависимостей
Как установить oma-scm
1Через маркетплейс плагинов
/plugin marketplace add first-fluke/oh-my-agent/plugin install oma@oh-my-agentКоманда ставит плагин oma целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-scm -a claude-code3Вручную: положить файлы
~/.claude/skills/oma-scm/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/oma-scm/
1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-scm -a codex2Вручную: положить файлы
.agents/skills/oma-scm/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-scm -a cursor2Вручную: положить файлы
.cursor/skills/oma-scm/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install first-fluke/oh-my-agent .agents/skills/oma-scm2Вручную: положить файлы
.github/skills/oma-scm/SKILL.md1Через Skills CLI (Vercel)
npx skills add first-fluke/oh-my-agent --skill oma-scm -a gemini-cli2Командой платформы
gemini skills install https://github.com/first-fluke/oh-my-agent --path .agents/skills/oma-scmВручную: положить файлы
.devin/skills/oma-scm/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об oma-scm
Как установить oma-scm в Claude Code?
Через маркетплейс: сначала /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent. Либо через npx skills add first-fluke/oh-my-agent --skill oma-scm -a claude-code.
Что делает oma-scm?
Управляет Git-историей: коммиты, ветки, merge, rebase, разрешение конфликтов, worktrees и release-базлайны. Агент получает процесс с явной областью действия и проверками перед каждым шагом.
Почему скилл не пушит напрямую в default-ветку?
Если в проектной конфигурации scm.require_pr_for_default_branch включён, скилл использует topic-ветку и PR. Прямой push возможен только по явной инструкции пользователя.
Исходный текст
SKILL.md · MIT
---
name: oma-scm
description: "Manage Git branches, merges, conflicts, commits, and release baselines. Use for repository history and change-management operations."
---
# Software Configuration Management
## Scheduling
### Goal
Perform Git operations with explicit scope, traceable commits, and recoverable history.
### Intent signature
- Commit, stage, push, branch, merge, rebase, resolve conflicts, manage worktrees, or inspect SCM governance.
### When to use
- Commit and push requests, including Conventional Commit messages and logical splitting.
- Branch/history operations, releases, baselines, CODEOWNERS, and configuration-management reviews.
### When NOT to use
- Implementing a feature or fixing application code -> use the owning specialist.
- General requirements planning -> use `oma-pm`; security/testing review -> use `oma-qa`.
### Expected inputs
Requested Git operation, repository state, and effective `scm` settings from project configuration.
### Expected outputs
Requested Git changes or an advisory plan, commit/branch identifiers, checks performed, and unresolved work.
### Dependencies
Git CLI; project configuration and hooks. Read the references below only for the selected operation.
## Structural Flow
### Entry
Inspect branch, upstream, staged/unstaged changes, and existing authorization. Select the commit path below or the configuration-management resource for broader operations.
### Transitions
- Commit-only request: finish after committing. Push or create a PR only when requested or required by the applicable workflow.
- Independent changes: split by feature. One logical change remains one commit even across code, tests, and docs; an explicit grouping instruction wins. File count is only a tiebreaker (at most five files lean single).
- Governance, worktrees, releases, or history operations: load `resources/cm-operations.md`.
- Large merges: load `resources/merge-risk.md` before selecting merge order or recovery steps.
- Default-branch push: apply the Push and PR safety section below.
### Failure and recovery
| Failure | Recovery |
|---|---|
| Unrelated dirty or staged files | Keep them outside the requested commit; never silently absorb them into an amend |
| Commit hook rejects a message | Fix the message or actual defect according to the hook; do not bypass it |
| Push is non-fast-forward | Fetch, inspect divergence, and integrate locally; do not retry with force |
| Conflicting changes | Preserve both intents, resolve, and run affected checks before completion |
| Likely secrets in the proposed diff | Stop before staging and identify the affected path without exposing the value |
### Exit
Report created commits/refs and verification. A failed commit, rejected push, or unresolved conflict is not completion.
## Logical Operations
### Canonical command path
1. Inspect the worktree and recent conventions:
```bash
git status -sb
git diff --staged
git diff
git log --oneline -5
```
2. Select logical commit groups under Transitions. Read `resources/conventional-commits.md` for message syntax, type, footer, and branch naming; apply repository hook/config limits.
3. Show the selected message. Stage explicit paths, inspect the staged diff, and commit using the prepared message file:
```bash
git add -- <specific-files>
git diff --cached --check
git diff --cached
git commit -F <message-file>
```
4. Inspect the resulting commit and remaining worktree. If push was requested, follow Push and PR safety, then report the remote result.
### Guardrails
1. Explicit, unambiguous user instructions take precedence over SCM defaults, including commit grouping and direct default-branch pushes. Existing authorization persists; do not ask for it again. Likely-secret material still requires stopping before staging.
2. Stage explicit paths. Do not use `git add -A` or `git add .` without explicit authorization, and never include credentials or secret files.
3. Do not rewrite shared history without explicit authorization. For an authorized rewrite, use `--force-with-lease`, never plain `--force`.
4. Read the staged diff before an amend. Unpushed commits may be amended or reorganized within the requested scope; pushed commits are shared history.
5. User-facing responses follow the configured language; commit messages, branch names, and PR titles/bodies stay in English.
### Push and PR safety (only when requested)
- Confirm the branch, upstream, and ahead/behind state before pushing.
- If `scm.require_pr_for_default_branch` is true, use a topic branch and PR for default-branch changes, unless the user explicitly requested a direct push.
- Keep the repository's required hooks/checks. A failure requires repair or an accurate partial result, not an assertion of success.
- Verify that the requested commits reached the intended remote branch.
### Amend, fixup, autosquash
Determine whether the target commit is shared using `git log --oneline @{u}..HEAD` when an upstream exists. If there is no upstream, inspect remote refs before assuming a commit is unshared. Keep unrelated staged changes out of the operation.
### Resource scope and effects
Git operations change the index, local commits/refs, worktrees, and possibly remote refs. Read only relevant project configuration; never copy credential values into messages or reports. Apply `.agents/skills/_shared/core/execution-policy.md` to authorization and verification.
## References
- Commit syntax, types, co-author policy, and branch naming: `resources/conventional-commits.md` (commit requests)
- Configuration-management operations: `resources/cm-operations.md` (governance/history/worktree tasks)
- Merge risk and rollback: `resources/merge-risk.md` (large merges)
- Ownership detail: `resources/codeowners-playbook.md` (CODEOWNERS work)
- Onboarding indicators: `resources/onboarding-risk-signals.md` (repository-risk assessment)
- Release observability: `../oma-observability/SKILL.md` §Integrations (release markers and baseline comparisons)
© First Fluke · MIT · first-fluke/oh-my-agent
Похожие скиллы
Все скиллы по теме «Git и GitHub» →Сначала — oma-scm от других авторов.