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

refit — скилл для Claude Code: что делает и как установить

Скилл refit для Claude Code проводит ретроспективу окружения агента по логам OMC и предлагает точечные исправления линтеров, конфигов и инструкций.

MIT 158 установок ★ 40 997 обновлён 2026-10-24

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

Что делает refit

Скилл анализирует трейсы сессий, отчёты об ошибках в каталоге .omc/logs/, отчёты о трении и блокноты планов из набора oh-my-claudecode. Он выявляет повторяющиеся задержки, сбойные проверки и недостающие логи, не оценивая при этом сам рабочий код проекта.

Каждая найденная проблема относится строго к одной из четырёх зон: детерминированные проверки (линтеры, хуки, CI), правила управления (CLAUDE.md, AGENTS.md), инструменты (.mcp.json, скрипты) или доступ к информации (логи серверов). Любые изменения вносятся только после одобрения каждой строчки пользователем.

Новые проверки обязательно тестируются на намеренно сломанном сценарии, иначе скилл возвращает их на доработку. В автономном режиме отчёт сохраняется в .omc/refit/pending-proposals.md и ждёт подтверждения.

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

  • найти повторяющиеся сбои и зависания агента по трейсам сессий
  • превратить ошибки в правила линтеров или шаги CI
  • дополнить CLAUDE.md и AGENTS.md стандартами без раздувания инструкций
  • зафиксировать точки трения в инструментах и конфигах .mcp.json

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

  • Проанализируй трейсы последних сессий через refit и покажи точки трения
  • Запусти ретроспективу окружения refit по файлам в .omc/logs/
  • Покажи отложенные предложения из .omc/refit/pending-proposals.md

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

1Через Skills CLI (Vercel)

npx skills add Yeachan-Heo/oh-my-claudecode --skill refit -a claude-code

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

~/.claude/skills/refit/SKILL.md

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

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

Вопросы о refit

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

Выполните команду npx skills add Yeachan-Heo/oh-my-claudecode --skill refit -a claude-code. Либо разместите файл скилла по пути ~/.claude/skills/refit/SKILL.md.

Что делает refit?

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

Что нужно для работы refit?

Нужны телеметрия и журналы oh-my-claudecode: файлы в .omc/logs/, блокноты планов или отчёты трения сессий, на основе которых формируются рекомендации.

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

SKILL.md · MIT
---
name: refit
description: Cross-session environment retrospective driven by OMC's own instrumentation — trace timelines, friction reports, logs, and plan notepads. Every finding lands on the surface that owns the fix (deterministic check, steering volume, tooling, or information access); nothing is written without user approval.
disable-model-invocation: true
---

# Refit

Refit surveys the environment the agent worked in — not the code it produced (review and verify own that) and not one launch run's lessons (the sediment pass owns that). Every kind of work leaves friction behind: a ralph loop that kept tripping on the same check, an autopilot run that stalled waiting for a signal, a debugging session where the decisive output was never captured anywhere. OMC instruments all of it. Refit reads the instruments and converts recorded friction into environment changes, so the next run starts in a better yard.

## Evidence first

The survey starts from OMC's instruments, not from a checklist. Read before asking the user anything:

- `trace_timeline` / `trace_summary` — where turns stalled, repeated, or fanned out wastefully
- `omc session friction report` — friction the session recorded about itself
- `.omc/logs/` and session state — errors, retries, swallowed failures
- plan notepads `.omc/notepads/*/issues.md` and `problems.md` — problems that accumulated across a plan
- the repo's own check surface (`package.json` scripts, CI workflows) — read before proposing any new check, because a check that exists but sits unwired or silently broken is the finding, not a reinvention

Findings emerge from what the data shows. An empty survey is a valid result and is stated plainly; an invented finding is the same violation as skipping the survey. A repo with no wired automated checks is itself a finding, not a neutral default.

## Four fix-owner surfaces

Every finding names the surface that owns its fix. A finding that fits no surface is declined, explicitly and with the reason.

1. **Deterministic check** — the failure was mechanical: a fixed syntactic pattern, a banned API, an import shape, a file-location rule. The fix is a lint rule, hook, or CI job — whichever the repo's existing guardrails make cheapest. Default to building the check over writing the rule.
2. **Steering surface** — the failure was a judgement call no guardrail substitutes for: cross-file consistency, matches-surrounding-style. The fix lands in the matching `docs/standards/` volume, or in `CLAUDE.md`/`AGENTS.md` within the thin-entry budget the launch sediment pass defines. Navigation pointers over prose.
3. **Tool surface** — the drag was tooling itself: expensive or token-inefficient MCP calls, missing automation, checks too slow to be run when they matter. The fix lands in `.mcp.json`, `scripts/`, hooks, or OMC config.
4. **Information surface** — the agent needed a signal it could not reach: dev-server logs, service state, third-party readonly access. The fix tees the log, exposes the state, or documents the access path.

The split rests on where enforcement pressure lives: implementation contexts carry the most of it (exploration, writing, and debugging all at once); review contexts receive a diff with none of it. Standards therefore belong to reviewers and checks — never to more instructions loaded onto the implementer.

## Proposal and landing

1. Present findings ranked by severity, each as `finding → surface → intended change`, with one line of instrument evidence (which instrument, what it showed).
2. Stop for user approval. Each line is individually approvable or vetoable.
3. Write approved findings to their surfaces. Before writing any steering prose, call the Skill tool with `agent-doc-discipline` and pass its verification checklist. A newly installed deterministic check must be proven to bite before it counts as landed: run it clean once, then demonstrate it failing on a deliberately introduced violation, then revert the violation. A check that cannot be shown failing goes back to the proposal — a guardrail nobody has seen fire is decoration, not protection.
4. Record where each finding landed — one file location per line — so the next refit starts from the record, not from memory. A refit on a launch-run session starts from that run's sediment list; a launch run may defer a lesson to a later refit by naming it.

## Headless refit (unattended invocation)

Refit is user-invoked, but its survey does not need the user at the keyboard to run — only to dispose. A host scheduler (cron, CI timer, an automation tool) may start a headless agent session that invokes this skill; the survey runs to its natural boundary under the same contract:

- The survey reads the same instruments and lands nothing anywhere: headless refit produces the proposal list only — `finding → surface → intended change`, each with one line of instrument evidence — written to `.omc/refit/pending-proposals.md` and, when a notification channel is configured (`configure-notifications`), summarized there so the user learns a survey is waiting.
- Nothing reaches a surface without the user's approval, exactly as in an interactive refit: proposals wait ranked, each independently vetoable, and the next interactive refit starts from the pending list instead of re-running the survey.
- An empty survey is stated plainly ("no findings"), never padded — inventing findings is the same violation as skipping the survey.

## Output

- Findings ranked by severity, each with evidence, surface, and intended change — every line independently decidable
- After approval: what landed and where
- Declined findings, with reasons

© Yeachan-Heo · MIT · Yeachan-Heo/oh-my-claudecode

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
after-action-report rampstackco Скилл after-action-report проводит разбор инцидента, запуска или завершённого проекта: восстанавливает ход событий, ищет причины и формирует действия. CX Codex +1 292установок re0-memo LilMGenius Скилл re0-memo для Claude Code и Codex извлекает уроки и барьеры качества из завершённого или неудачного цикла разработки. Запускается после сборок, QA, замечаний пользователя или перед перезапуском с нуля. CX Codex +1 1 400установок om-pipeline-retro open-mercato Скилл om-pipeline-retro анализирует завершённые прогоны пайплайна, находит причины повторных попыток и считает потерянные часы. Пригодится на ретроспективе разработки. CX Codex +1 3 100установок run-learning-retrospective cursor Скилл run-learning-retrospective для Claude Code проводит ретроспективу обучения: сверяет сделанное с целями, находит повторяющиеся блокеры и правит план. Запускается после закрытия очередного этапа. CX Codex +1 937установок iterate-retrospective product-on-purpose Скилл iterate-retrospective помогает провести командную ретроспективу, разобрать успехи и сбои спринта, а затем зафиксировать задачи с дедлайнами и ответственными. CX Codex +1 832установок iterate-lessons-log product-on-purpose Скилл iterate-lessons-log для Claude Code. Пишет структурированную запись о выводах после инцидента или завершённого проекта — контекст, события, вывод, рекомендации, условия применимости. CX Codex +1 810установок

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

Весь набор →
diagram Скилл diagram для Claude Code выбирает компактный способ показать структуру кода — от дерева вызовов до Mermaid-схемы. Показывает связи наглядно, когда их трудно удержать в текстовом описании. CX Codex +1 194установок ask-navigator Скилл ask-navigator, который превращает неясную задачу в карту решений на issue-трекере репозитория. Работает с открытым фронтом по одному тикету за сессию, пока маршрут не прояснится. CX Codex +1 191установок loft Скилл loft разрешает спорные вопросы архитектуры и дизайна с помощью одноразового прототипа, который не попадает в main. CX Codex +1 189установок intent Собирает из переписки или устного описания согласованный intent.md для команды разработки. Подходит для передачи решений в /launch без написания кода. CX Codex +1 187установок pr Скилл pr для Claude Code собирает описание пулл-реквеста по следам работы агента в сессии. Формирует готовую сводку с доказательствами проверок и оценкой отката изменений. CX Codex +1 161установок map Скилл map для Claude Code направляет задачу к подходящему скиллу из набора. Он сопоставляет запрос с этапом работы или отдельным сценарием, но сам задачу не выполняет. CX Codex +1 160установок session-flow Скилл session-flow для Claude Code восстанавливает карту цели, поворотов, результатов, текущего шага и открытых решений по истории сессии. Запускается после смены сессии или её сжатия. CX Codex +1 118установок research Скилл research исследует открытый вопрос по коду и документации, затем выдаёт выводы с источниками. Запускайте его, когда следующий шаг зависит от ещё не проверенного факта. CX Codex +1 1установок

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

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