Когда это нужноWhen to reach for itКоли це потрібно
Хорошо понятный баг: новых проектных решений нет, последствия правки ограничены, локальной проверки достаточно. Например: /fix retry loop never backs off, hammers the server on 503.A well-understood bug: no new design decisions, a bounded blast radius, and local validation is enough. For example /fix retry loop never backs off, hammers the server on 503.Добре зрозумілий баг: нових проєктних рішень немає, наслідки правки обмежені, локальної перевірки досить. Наприклад: /fix retry loop never backs off, hammers the server on 503.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Читает файлы проектаReads the files of your projectЧитає файли проєкту
- Правит файлы проектаEdits files in your projectЗмінює файли проєкту
- Запускает команды (проверки, git)Runs commands (checks, git)Запускає команди (перевірки, git)
- Работает сWorks withПрацює з
- Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
- Где выполняются шагиWhere the steps happenДе виконуються кроки
- Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
- Где это лежит в kitWhere it lives in the kitДе це лежить у kit
.claude/skills/fix/SKILL.md
Не используйте /fix, если правка требует решений по дизайну или UX (/ui-clarify, затем /spec), вводит новую абстракцию, схему или миграцию либо публичный API (/spec), или если вы ещё не понимаете первопричину (сначала /research). Правка в один токен - это /quick. Если по ходу список файлов вырастает больше чем до нескольких, агент останавливается и передаёт задачу в /spec.Do not use /fix when the fix needs design or UX decisions (/ui-clarify, then /spec), adds an abstraction, a schema or migration, or a public API (/spec), or when you do not yet understand the root cause (/research first). A one-token edit is /quick. If the file list outgrows a handful of files midway, the agent stops and escalates to /spec.Не використовуйте /fix, якщо правка потребує рішень щодо дизайну чи UX (/ui-clarify, потім /spec), вводить нову абстракцію, схему чи міграцію або публічний API (/spec), або якщо ви ще не розумієте першопричину (спершу /research). Правка в один токен - це /quick. Якщо посеред роботи список файлів виростає більше ніж до кількох, агент зупиняється й передає задачу до /spec.
ШагиStepsКроки
- Опишите сломанное поведение:
/fix list scroll position jumps to top after returning from detail.Describe the broken behaviour:/fix list scroll position jumps to top after returning from detail.Опишіть зламану поведінку:/fix list scroll position jumps to top after returning from detail. - Агент подтверждает, что путь действительно падает, и называет первопричину до того, как тронет код. Если назвать её не получается, он останавливается и сначала исследует (
/research, мысленно или всерьёз).The agent confirms the failing path and names the root cause before it touches code. If it cannot name it, it stops and researches first (/research, mentally or for real).Агент підтверджує, що шлях справді падає, і називає першопричину, перш ніж торкнеться коду. Якщо назвати її не виходить, він зупиняється й спершу досліджує (/research, подумки чи всерйоз). - Он перечисляет файлы, которые собирается менять, и объясняет зачем. Если список вырастает больше чем до нескольких файлов или начинают требоваться новые типы, он останавливается и передаёт задачу в
/spec.It lists the files it expects to touch and why. If the list grows past a handful of files or starts needing new types, it stops and escalates to/spec.Він перелічує файли, які збирається змінювати, і пояснює навіщо. Якщо список виростає більше ніж до кількох файлів або починають бути потрібними нові типи, він зупиняється й передає задачу до/spec. - Он вносит самую маленькую правку, которая устраняет первопричину, а не симптом: без рефакторинга по соседству, без чистки посторонних импортов, без россыпи комментариев. Существующие комментарии и инварианты в этом месте учитываются, правила против мусора действуют. Обработанный крайний случай или неочевидная причина заслуживают одного комментария «почему» на языке
<ARTIFACT_LANGUAGE>и не больше.It applies the smallest change that fixes the root cause, not the symptom: no surrounding refactor, no unrelated import cleanup, no comment spray. Existing comments and invariants in the area are honoured, and anti-slop rules apply. A handled edge case or a non-obvious cause earns one comment saying why, written in<ARTIFACT_LANGUAGE>, nothing more.Він вносить найменшу правку, що усуває першопричину, а не симптом: без рефакторингу поруч, без чищення сторонніх імпортів, без розсипу коментарів. Наявні коментарі та інваріанти в цьому місці враховуються, правила проти сміття діють. Оброблений крайній випадок чи неочевидна причина заслуговують на один коментар «чому» мовою<ARTIFACT_LANGUAGE>і не більше. - Он запускает самую узкую осмысленную проверку, которая доказывает исправление: целевой тест, если он есть (добавляет или правит тест, когда это дёшево и в проекте есть тесты), иначе компиляцию и ручной прогон этого пути. Результат записывается как
expected | actual.It runs the narrowest meaningful check that proves the fix: a targeted test if one exists (adding or adjusting one if that is cheap and the project has tests), otherwise a compile and a manual run of the path. The result is recorded asexpected | actual.Він запускає найвужчу змістовну перевірку, що доводить виправлення: цільовий тест, якщо він є (додає чи правит тест, коли це дешево й у проєкті є тести), інакше компіляцію та ручний прогін цього шляху. Результат записується якexpected | actual. - Он отчитывается тремя строками: первопричина, правка, проверка. Соседние баги, если они попались, перечисляются как последующие задачи и в этом проходе не исправляются.It reports in three lines: root cause, fix, validation. Adjacent bugs it found are listed as follow-ups and are not fixed in this pass.Він звітує трьома рядками: першопричина, правка, перевірка. Сусідні баги, якщо трапилися, перелічуються як подальші задачі й у цьому проході не виправляються.
Отчёт из трёх строк: первопричина, правка и результат проверки, по одной строке на каждое, плюс список соседних багов, оставленных на потом, если такие нашлись. Изменение затрагивает только то, чего требовала первопричина.A three-line report: root cause, fix and validation result, one line each, plus a list of adjacent bugs left for later if any were found. The change touches only what the root cause required.Звіт із трьох рядків: першопричина, правка й результат перевірки, по одному рядку на кожне, плюс список сусідніх багів, залишених на потім, якщо такі знайшлися. Зміна зачіпає лише те, чого вимагала першопричина.
СоветыTipsПоради
- Соседние баги идут в список последующих задач, а не в этот проход. Если такой баг настоящий и требует отдельного расследования, отложите его в виде заготовки и работайте дальше.Adjacent bugs go on the follow-up list, not into this pass. When one is real and needs its own investigation, park it as a stub and keep working.Сусідні баги йдуть у список подальших задач, а не в цей прохід. Якщо такий баг справжній і потребує окремого розслідування, відкладіть його у вигляді заготовки й працюйте далі.
- После правки проверка запуском покажет, держится ли она в работе, а не только прошла ли дешёвая проверка.After the fix, a run-and-observe check shows whether it holds when exercised, not only that the cheap check passed.Після правки перевірка запуском покаже, чи вона тримається в роботі, а не лише чи пройшла дешева перевірка.
Связанные функцииRelated functionsПов'язані функції
- Внести мелкую правку без церемонийMake a one-line edit without ceremonyВнести дрібну правку без церемонійОпечатка, константа или подпись исправлены за одно предложение: без спеки и без сборки.A typo, a constant or a label changed in one sentence's worth of work: no spec, no build gate.Одруківку, константу чи підпис виправлено за одне речення: без спеки й без збірки.
- Превратить описание фичи в утверждённую стратегическую спекуTurn a feature description into an approved strategic specПеретворити опис фічі на затверджену стратегічну спеку
/specпишет, что и зачем нужно в фиче, без имён классов и путей к файлам, утверждает и передаёт/spec-tech. Мелкую задачу делает на месте./specwrites the what and why of a feature with no class names or file paths, approves it and passes it to/spec-tech. A small task is built in place./specпише, що й навіщо потрібно у фічі, без назв класів і шляхів до файлів, затверджує та передає/spec-tech. Дрібну задачу робить на місці. - Изучить область, прежде чем её менятьInvestigate an area before you change itВивчити ділянку, перш ніж її змінюватиОдин продуманный проход чтения оставляет черновое досье и, для тикета, долговечные выводы, чтобы никто не искал одно и то же пять раз.One deliberate reading pass leaves a scratch dossier and, for a ticket, durable findings, so nobody greps the same things five times.Один продуманий прохід читання лишає чорнове досьє і, для тікета, довговічні висновки, щоб ніхто не шукав те саме п'ять разів.
- Отложить находку вне задачи и продолжить работуPark an out-of-scope finding and keep workingВідкласти знахідку поза задачею й продовжити роботуНастоящая проблема, замеченная по ходу дела, становится минимальной заготовкой со статусом Draft за одну строку, и вы сразу возвращаетесь к своему делу.A real problem found mid-task becomes a minimal Draft stub in one line, and you go straight back to what you were doing.Справжню проблему, помічену по ходу діла, перетворено на мінімальну заготовку зі статусом Draft за один рядок, і ви одразу повертаєтеся до своєї справи.
- Запустить изменение и проверить, что оно правда работаетRun a change and see whether it actually worksЗапустити зміну й перевірити, що вона справді працюєЗапустить и посмотреть: проверка заканчивается одной строкой, PASS, DEFECT, COULD NOT VERIFY или NOT APPLICABLE, с путём к свидетельствам.Run the thing and observe it: the check ends in one line, PASS, DEFECT, COULD NOT VERIFY or NOT APPLICABLE, with the path to its evidence.Запустити й подивитися: перевірка закінчується одним рядком, PASS, DEFECT, COULD NOT VERIFY або NOT APPLICABLE, зі шляхом до свідчень.