AIKraft/AI/Войти
AIKraft/Skills/без обходных путей

без обходных путей

Fix problems at their root cause instead of patching symptoms. Use when debugging, fixing bugs, resolving test failures, planning a solution, or reviewing a change — especially where a fix would silence a signal (type assertion, lint suppression, swallowed error, timing hack, monkey patch) rather than repair its source. Not for formatting- or docs-only edits.

pedronauck official Документы

Что делает навык

Skill устраняет проблемы в их первопричине, а не заглушает симптомы, такие как приведение типов, подавление линтера или проглатывание ошибок. Он применяется для исправления багов, падающих тестов и ревью изменений, где важно не маскировать диагностические сигналы.

Когда применять

  • Отладка и исправление багов, где текущее решение лишь скрывает ошибку.
  • Устранение падающих тестов путем исправления источника сбоя, а не игнорирования результата.
  • Ревью изменений, содержащих костыли, фиксированные задержки (fixed sleeps) или monkey patches.
  • Планирование решения проблем, требующих выявления корневой причины, а не временных обходных путей.

Как работает

  1. Начните с уже собранных данных; используйте systematic-debugging только если причина остается неясной.
  2. Отследите наблюдаемый сбой к его собственному коду или границе, исправьте причину и проверьте исходный симптом в существующем наборе тестов.
  3. Проанализируйте приведения типов, подавления, проглоченные ошибки, фиксированные задержки и цепочки резервных вариантов как сигналы для расследования.
  4. При внешних дефектах изолируйте необходимый адаптер на границе, объясните доказательства и условие удаления, используя существующий набор тестов для защиты поведения.
  5. Сохраните намеренную проверку границ и совместимость, если это требуется политикой проекта; держите исправление сфокусированным без лишней очистки архитектуры.

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

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

Что понадобится

  • Файл references/workaround-catalog.md
  • Файл references/philosophical-foundations.md (опционально)

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «no-workarounds» из репозитория: # https://github.com/pedronauck/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r no-workarounds/ ~/.claude/skills/no-workarounds/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.