om-fix-issue — скилл для Claude Code: что делает и как установить
Скилл om-fix-issue для Claude Code и Codex разбирает issue из трекера, пишет исправление с тестами и оставляет файлы в staged-состоянии для ручной проверки без коммита или создания PR.
MIT 502 установок ★ 282 обновлён 2026-10-22
npx skills add open-mercato/skills --skill om-fix-issue -a claude-codeЧто делает om-fix-issue
Скилл координирует цепочку вспомогательных инструментов для исправления задач. Сначала запускается квалификация через om-verify-in-repo в изолированном worktree. Если проблема подтвердилась, скилл фиксирует причину с помощью om-root-cause, требует обязательного падения регрессионного теста до правок и блокирует редактирование тестов через временный файл .om-freeze-tests.
Затем вызывается om-fix, а готовый дифференциал уходит на независимую проверку в om-code-review. Для профилей multi и high-assurance рецензирование проводит отдельный совет советников в изолированных контекстах моделей. По правилам безопасности скилл никогда не выполняет git commit, git push и не создаёт pull request: готовый результат остаётся проиндексированным в git stage вместе с отчётом валидации.
Для работы требуются установленные базовые скиллы цепочки (om-verify-in-repo, om-root-cause, om-fix, om-code-review). При флаге --abort или сбое пайплайна скилл автоматически снимает метку in-progress и освобождает назначение задачи в трекере.
Какие задачи решает
- разобрать и подтвердить баг по номеру issue в изолированном worktree
- проверить воспроизводимость регрессионным тестом до внесения правок в код
- провести независимое код-ревью в чистом контексте модели
- подготовить проверенные изменения в staged без создания коммита и PR
Примеры запросов агенту
- Исправь issue #142, но остановись до создания PR
- Подготовь фикс для PROJ-88 и оставь изменения staged
- Запусти
om-fix-issue 405 --profile high-assurance
Как установить om-fix-issue
1Через Skills CLI (Vercel)
npx skills add open-mercato/skills --skill om-fix-issue -a claude-code2Вручную: положить файлы
~/.claude/skills/om-fix-issue/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/om-fix-issue/
1Через Skills CLI (Vercel)
npx skills add open-mercato/skills --skill om-fix-issue -a codex2Вручную: положить файлы
.agents/skills/om-fix-issue/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add open-mercato/skills --skill om-fix-issue -a cursor2Вручную: положить файлы
.cursor/skills/om-fix-issue/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install open-mercato/skills skills/om-fix-issue2Вручную: положить файлы
.github/skills/om-fix-issue/SKILL.md1Через Skills CLI (Vercel)
npx skills add open-mercato/skills --skill om-fix-issue -a gemini-cli2Командой платформы
gemini skills install https://github.com/open-mercato/skills --path skills/om-fix-issueВручную: положить файлы
.devin/skills/om-fix-issue/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add open-mercato/skills --skill om-fix-issue -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об om-fix-issue
Как установить om-fix-issue в Claude Code?
Выполните команду npx skills add open-mercato/skills --skill om-fix-issue -a claude-code.
Что делает om-fix-issue?
Скилл диагностирует ошибку по идентификатору issue, воспроизводит её падающим тестом, вносит исправление, прогоняет код-ревью и оставляет готовые файлы в staged без коммита.
Что нужно для работы om-fix-issue?
В окружении должны присутствовать сопутствующие скиллы пайплайна: om-verify-in-repo, om-root-cause, om-fix и om-code-review.
Исходный текст
SKILL.md · MIT
---
name: om-fix-issue
description: Qualify and fix a tracker issue through the existing lower-level analysis, implementation, test, and review skills, then leave a verified staged branch for human review without committing, pushing, or opening a pull request. Use when the user says "fix this issue but stop before PR", "leave the fix staged", "staged issue fix", "napraw issue bez PR", or "zostaw zmiany staged".
---
# Fix Issue for Human Review
Drive a real issue fix to a staged, reviewable handoff. Use the configured
harness profile for optional workers and independent reviewers while leaving all
existing pipeline skills unchanged.
## Arguments
- `--interactive` (default) or `--autonomous` — apply the execution mode throughout this workflow; never enable publication. Reject both together.
- `{issueId}` (required) — tracker issue identifier.
- `{repo}` (optional) — repository handle understood by the tracker descriptor.
- `--profile <standard|optimized|multi|multi-optimized|high-assurance>` (optional) — default `standard`.
- `--force` (optional) — override an active claim only after explicit user confirmation.
- `--abort` (optional) — release this harness run's issue claim without publishing.
## Chaining
Consume the issue or brief and requested profile. Invoke the base workflow and its lower-level companions by name; stop with the missing name if one is unavailable. Emit the staged handoff, optional `Issue:`/`Spec:` references, and final `WORKTREE=` line. Publication is a separate human-authorized step.
## Workflow
**Claims:** `references/claim-pr.md` governs atomic/fallback ownership and release.
**ALWAYS check first:** Apply `.ai/skills/om-fix-issue/SKILL.md` when present; safety rules still win.
0. **Agentic setup** — follow `references/agentic-setup.md` before any action: load approved configuration, apply local extensions and shared rules, and preserve the untrusted-content boundary.
### 1. Preflight and trusted profile
Follow `references/issue-workflow.md` to enforce claim concurrency, resolve a
trusted base-revision harness config plus optional user-local overlay, validate
the requested profile, and probe its selected models.
### 2. Qualify the issue
Run `om-verify-in-repo` verbatim. Stop on `NO_ACTION_NEEDED`, citing its
evidence. Do not claim the issue before this gate says work is needed.
### 3. Isolate and diagnose
Create an isolated worktree and capture the harness start-state artifact. Run `om-root-cause`
verbatim. For `multi`, `multi-optimized`, and `high-assurance`, review the root-cause brief through the harness
before implementation using the bound `om-code-review` council contract: a
fresh Claude context plus every configured advisor receives the same immutable
diagnosis packet. Re-investigate any confirmed diagnosis blocker.
### 4. Implement and verify
Invoke `om-fix` with the root-cause brief before any implementation. It owns
the issue claim and observed failing regression first. Inside its implementation
phase, optimized profiles dispatch bounded worker packets; `high-assurance`
uses manifest packets with blind review, fresh verification, and exact-diff
gates. Resume that owning workflow for integration, validation, and self-review.
Require the regression test to be observed failing for
the diagnosed reason before the fix is applied, and record that red run in the
run artifacts. When the prevention hooks are installed, write the exact test
paths as a JSON array to `.om-freeze-tests` at the worktree root after the red run and remove it before
staging, so the fix loop cannot edit tests. A worker packet never replaces
that gate.
### 5. Review and preview
Run `om-code-review` on the complete uncommitted diff. For `standard` and
`optimized`, create a new Claude context with no inherited implementation
transcript and run the skill there. For `multi`, `multi-optimized`, and
`high-assurance`, follow the `om-harness` bound council contract: freeze the
exact diff, validation evidence, and repository rules; start fresh Claude and
every configured advisor concurrently with the same complete `om-code-review`
rubric and packet; then require Claude's matching artifact before
reconciliation. Reconcile every finding against code or
runtime evidence. Every configured council reviewer must complete — the runtime retries failures and a council missing any required reviewer yields no verdict; re-run it, repair the binding, or stop for the user's decision. For UI changes, run local verification through
`om-auto-qa-pr` without a PR number.
### 6. Stage the handoff
Follow the shared `om-harness` stage-only contract. Supply the final implementation `--review-packet` and approved `--host-review`
artifacts even in `standard` mode. Stage only allowlisted
intended files, assert refs and reflogs still match the captured start state,
and require a clean staged diff.
Keep the issue claim while the staged branch awaits human review. Render the
report from `references/report-templates.md` and stop.
### 7. Abort or failure cleanup
After capture, follow the `om-harness` stage-only contract to stop active
processes and invoke `end-run` on abort or terminal failure. Preserve the
guard while repairing or retrying the same run; successful staging ends it.
On `--abort`, or on failure after `om-fix` claimed the issue but before a ready
staged handoff exists, release the whole claim — remove the `in-progress` label
through `unlabel-issue`, remove the harness assignee, and post an abort comment
through `comment-issue` — so the issue is not fenced off from later runs. Never
discard staged work unless the user explicitly asks.
## Rules
- Shared communication, marker, label, and safety rules: `references/rules.md`. They always apply.
- For any non-`standard` profile, show the user the probe readiness table (model, binding, role, ✅ ready / ❌ missing-or-failed) before invoking any model.
- After every council round, paste the reviewer-status table and the findings-by-model matrix from the generated `review-summary.md` verbatim into the conversation; the final report repeats the final round's tables.
- Never invoke `om-open-pr`, `om-auto-fix-issue`, `om-auto-create-pr`, or another publication-oriented skill.
- Never commit, push, publish, or execute the tracker `create-pr` operation.
- Keep the issue claim only for a successful staged handoff; release it on abort or failed runs.
- Never count a reviewer from the worker's model family as independent confirmation.
- Never run a required Claude review in the conductor's implementation context; inability to create a fresh Claude context is blocking.
- Never weaken tests or validation to obtain a green result.
- Never modify or clean the user's primary-worktree changes.
© open-mercato · MIT · open-mercato/skills