К основному содержанию
скилл CX Codex

fix · buiducnhat — скилл для Claude Code: исправление ошибок

Скилл fix помогает найти причину конкретной ошибки, внести небольшое исправление и проверить результат. Он рассчитан на задачи с понятным воспроизведением и ограниченным риском.

MIT 280 установок ★ 48 обновлён 2026-07-06

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add buiducnhat/cobrew --skill fix -a claude-code
Открыть на GitHub

Что делает fix

Сначала скилл разбирает ожидаемое и фактическое поведение, шаги воспроизведения и доступные свидетельства: например, логи или упавший тест. Затем предлагает воспроизвести ошибку, проследить путь данных или управления до причины и внести минимальное изменение. Если отчёт неполный, есть шаблон для сбора деталей.

После правки скилл запускает проверки от узких к более широким: сначала для изменённого поведения, затем соседние регрессионные проверки и подходящие проверки проекта. Исправление нельзя считать готовым, пока ошибка не воспроизводится и ожидаемое поведение не подтверждено. Если причина неясна, затронуто несколько подсистем или риск требует поэтапного плана, работа останавливается и передаётся в brainstorm или write-plan.

Для Claude Code установка выполняется командой npx skills add buiducnhat/cobrew --skill fix -a claude-code; файл скилла размещается в ~/.claude/skills/fix/SKILL.md. Скилл не предназначен для масштабных изменений архитектуры: при таком объёме он требует перейти к планированию.

Какие задачи решает

  • найти причину ошибки по шагам воспроизведения и логам
  • исправить регрессию и добавить проверку для неё
  • сопоставить фактическое поведение с ожидаемым
  • остановить локальную правку, если затронуты несколько подсистем

Примеры запросов агенту

  • Разбери эту ошибку: ожидается вход в систему, но после отправки формы появляется исключение; вот логи и шаги воспроизведения.
  • Найди причину регрессии в этом тесте, внеси минимальную правку и проверь соседние тесты.
  • Проверь, можно ли исправить это локально; если нужны изменения нескольких подсистем, остановись и предложи план.

Как установить fix

1Через Skills CLI (Vercel)

npx skills add buiducnhat/cobrew --skill fix -a claude-code

2Вручную: положить файлы

~/.claude/skills/fix/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/fix/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о fix

Как установить fix в Claude Code?

Выполните npx skills add buiducnhat/cobrew --skill fix -a claude-code. Файл скилла размещается в ~/.claude/skills/fix/SKILL.md.

Что делает скилл fix?

Он воспроизводит конкретную ошибку, ищет её первопричину, вносит небольшое исправление и проверяет результат. При росте объёма или риска передаёт задачу к планированию.

Когда fix передаёт задачу в brainstorm или write-plan?

Когда причина остаётся неясной, нужны изменения нескольких подсистем, миграция или масштабный рефакторинг. Также эскалация нужна, если проверка выявляет широкие регрессии.

Исходный текст

SKILL.md · MIT
---
name: fix
description: Diagnose and fix bugs with root-cause analysis and verification. Use when you have a concrete issue report, failing behavior, runtime error, or test regression that should be resolved safely. Stop and escalate to brainstorm when scope or risk grows.
argument-hint: "[bug report or issue description]"
license: MIT
---

# Fix

## Scope Gate (Required Before Starting)

Use this skill only when all conditions below are true:

1. **Concrete issue signal exists**
   - Clear failing behavior, error, or regression is identified
   - Enough evidence exists to begin diagnosis (logs, stack trace, failing test, or reproducible steps)

2. **Likely localized fix path**
   - Issue appears constrained to a small area
   - No expected cross-system redesign or migration

3. **Low-to-moderate architectural risk**
   - Fix can be made without foundational changes
   - No phased rollout/feature-flag strategy is expected

4. **Straightforward verification path**
   - Reproduction and post-fix checks can be run in practical scope
   - Success criteria can be validated directly

If any condition fails, escalate to `brainstorm` or `write-plan`.

## Hard Stop Escalation Criteria

Immediately stop and switch to planning if any of these occur:

- Root cause remains unclear after focused investigation
- Fix requires cross-cutting architectural or data-model changes
- Scope expands into large refactor or multi-module migration
- Security/compliance-sensitive behavior is involved
- Verification reveals broad regressions requiring phased mitigation
- Multiple fix attempts fail without converging on a root cause

Escalation action:

1. Stop all implementation activities.
2. Output the exact message: "This fix exceeds safe single-pass debugging limits. Ask, Recommend `brainstorm` or `write-plan` first to define phased diagnosis, implementation, and risk controls."

## Workflow

### Step 1: Intake and Contextualize

1. Understand the reported bug and define explicit expected behavior.
2. Collect/confirm minimum bug report fields:
   - Title
   - Expected behavior
   - Actual behavior
   - Reproduction steps
   - Evidence (logs, trace, screenshot, failing test output)
   - Environment (branch/OS/runtime/version if relevant)
   - Impact/severity
3. Load only the project context relevant to the bug:
   - If `docs/SUMMARY.md` exists, read it first.
   - Load only task-relevant detail docs.
   - Prioritize `Code Standard` docs for implementation conventions.
   - If docs conflict with code or user intent, use the available input/question tool before broad changes.

### Step 2: Reproduce and Diagnose

1. Reproduce the issue consistently.
2. Locate the failure point (file/function/line range/subsystem).
3. Trace control/data flow to identify the **root cause**.
4. Form a fix hypothesis and confirm it explains observed behavior.

Guidelines:

- Read surrounding code, not only the failing line.
- Prefer root-cause correction over symptom patching.
- Add temporary diagnostics only when needed; remove them after use.

### Step 3: Decide Small vs Bigger Fix

Classify the work before coding:

#### Small fix (continue in this skill)

Most are true:

- Root cause is clear and validated
- Change surface is narrow (typically a few files)
- Regression risk is limited and testable quickly

#### Bigger/risky fix (escalate to `brainstorm` or `write-plan`)

Any are true:

- Root cause is uncertain
- Multiple subsystems must change together
- Requires migration, rollout sequencing, or broad refactor
- Risk cannot be reasonably controlled in a single pass

If it is a bigger fix, follow **Hard Stop Escalation Criteria**.

### Step 4: Implement (Small Fix Path)

1. State a brief 1-3 bullet implementation plan.
2. Apply the smallest targeted change that resolves the root cause.
3. Keep scope strict; avoid unrelated refactors.
4. Add/update regression tests when applicable.

### Step 5: Verify

Run validation in increasing scope:

1. Focused checks for the changed behavior/module
2. Nearby regression checks
3. Relevant project checks (lint/typecheck/tests/build) as needed

Fix is complete only when:

- Reproduction no longer fails
- Expected behavior is confirmed
- No critical regressions are introduced

If verification indicates broader impact, escalate to `brainstorm` or `write-plan`.

### Step 6: Complete and Report

Provide a concise completion report with:

- **Root cause**
- **What changed**
- **Why this fix works**
- **Verification performed and results**
- **Residual risks / follow-ups**

If behavior or documentation-relevant rules changed, update the minimal relevant docs. If architecture changed, this should have been escalated.

## Rules

- Do not guess when key context is missing.
- Always prioritize root-cause fixes.
- Keep blast radius minimal.
- Do not mark done without verification.
- Escalate early when scope/risk exceeds this skill.

## Optional Bug Report Template

Use when the report is incomplete:

- Title:
- Expected behavior:
- Actual behavior:
- Reproduction steps:
- Error logs/stack trace:
- Environment:
- Impact/severity:
- Additional context:

© buiducnhat · MIT · buiducnhat/cobrew

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — fix от других авторов.

fix react Скилл fix для Claude Code исправляет форматирование и помогает разбирать ошибки линтера. Его запускают перед коммитом, чтобы проверить готовность к CI. CX Codex +1 2 300установок fix Alireza Rezvani Скилл fix для Claude Code разбирает падающий или нестабильный Playwright-тест по категориям и исправляет его, чтобы добиться стабильного прохождения в CI. CX Codex +1 1 638установок fix parcadei Скилл fix для Claude Code: разбирает баг по цепочке от диагностики до коммита. Стартует с вопросов — что чинить, насколько глубоко копать, нужен ли тест и коммит. CX Codex +1 488установок fix davepoon Скилл fix собирает данные об уязвимости по её идентификатору и предлагает конкретные шаги обновления зависимостей для репозитория. CX Codex +1 ★ 3 785звёзд репо fix TakaGoto Скилл fix для Claude Code диагностирует сбои в готовом RAG-пайплайне и правит код без теории. Разбирает мусорную выдачу и галлюцинации модели. CX Codex +1 ★ 30звёзд репо fix-issue OrchestKit Скилл fix-issue разбирает GitHub issue, ищет корневую причину, вносит исправление с тестами и создаёт PR со ссылкой на issue. CX Codex +1 217установок w-debug blockmatic-icebox Скилл w-debug для Claude Code помогает найти причину сбоя по логам и воспроизведению. После исправления он повторно запускает исходный сценарий и затронутые проверки. CX Codex +1 647установок bugfix ulpi-io Скилл bugfix для Claude Code ведёт отладку: требует воспроизвести ошибку падающим тестом, найти первопричину и внести минимальную правку без ослабления проверок. CX Codex +1 176установок focused-fix Alireza Rezvani Скилл focused-fix для Claude Code разбирает сломанную функцию или модуль и ведёт ремонт по этапам. Он включается, когда нужно наладить целую область проекта, а не исправить один сбой. CX Codex +1 600установок bug-fix bobmatnyc Скилл bug-fix задаёт системный процесс устранения багов: от воспроизведения и поиска первопричины до проверки исправления и написания регрессионных тестов. CX Codex +1 488установок red-green-proof RooAGI Плагин red-green-proof превращает подозрение на баг в проверяемое доказательство через цикл теста: падение, исправление и повторный откат. CX Codex ★ 1 596звёзд репо

Из того же набора7

brainstorm Скилл brainstorm помогает разобрать сложную или неясную задачу через диалог до написания кода. Скилл задаёт вопросы, оценивает варианты архитектуры и готовит дизайн-документ. CX Codex +1 628установок execute-plan Скилл execute-plan прогоняет утверждённый план реализации по фазам, отмечает прогресс в SUMMARY.md и останавливается, если что-то пошло не так. CX Codex +1 559установок write-plan Скилл write-plan готовит подробный план реализации для сложных и рискованных правок, не трогая код. Пригодится перед крупным рефакторингом или миграцией. CX Codex +1 526установок quick-implement Скилл quick-implement для небольших правок с понятными критериями приёмки. Помогает агенту не разводить многофазный план там, где хватит одной итерации. CX Codex +1 439установок ask Скилл ask останавливает поспешную генерацию кода и задаёт уточняющие вопросы по одному, помогая собрать требования перед реализацией задачи. CX Codex +1 305установок review Скилл review проверяет незакоммиченные правки в git с полным контекстом файлов, расставляет уровни критичности и выносит вердикт. CX Codex +1 279установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой