tech-debt · anthropics — скилл для Claude Code: аудит и приоритеты техдолга
Разбирает технический долг по категориям и расставляет приоритеты по формуле. Пригодится, когда непонятно, что рефакторить первым.
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a claude-codeЧто делает tech-debt
Скилл проводит аудит техдолга и делит находки на шесть типов: код, архитектура, тесты, зависимости, документация, инфраструктура. Для каждого типа указан свой риск — от медленной разработки до уязвимостей и простоев. Дальше каждая позиция получает оценку по трём шкалам от 1 до 5: влияние на команду, риск от бездействия и трудоёмкость правки. Трудоёмкость считается в обратную сторону, поэтому мелкая правка поднимается выше крупной.
Приоритет выводится как (Impact + Risk) x (6 - Effort). На выходе — список по убыванию приоритета с оценкой усилий и обоснованием для каждой строки, плюс план по этапам, который можно вести параллельно с обычными задачами. Формула простая, и это её плюс: спорить о коэффициентах проще, чем о вкусах.
Скилл не запускает линтеры и не читает метрики покрытия сам — оценки ставит модель по вашему коду и описанию проекта. Если в репозитории нет тестов и документации, часть категорий останется пустой, и это нормально: аудит покажет только то, что видно из кода.
Какие задачи решает
- понять, какие модули тянут разработку вниз
- отделить срочный рефакторинг от косметического
- объяснить руководству, почему долг стоит закрывать
- разложить крупный рефакторинг на этапы рядом с фичами
- найти устаревшие и заброшенные зависимости
Примеры запросов агенту
- Проведи аудит техдолга в этом репозитории и расставь приоритеты
- Что нам стоит отрефакторить в первую очередь?
- Оцени здоровье кода и собери план поэтапного исправления
Как установить tech-debt
1Через Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a claude-code2Вручную: положить файлы
~/.claude/skills/tech-debt/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tech-debt/
1Через Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a codex2Вручную: положить файлы
.agents/skills/tech-debt/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a cursor2Вручную: положить файлы
.cursor/skills/tech-debt/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install anthropics/knowledge-work-plugins tech-debt2Вручную: положить файлы
.github/skills/tech-debt/SKILL.md1Через Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a gemini-cli2Командой платформы
gemini skills install https://github.com/anthropics/knowledge-work-plugins --path engineering/skills/tech-debtВручную: положить файлы
.devin/skills/tech-debt/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tech-debt
Как установить tech-debt в Claude Code?
Выполните npx skills add anthropics/knowledge-work-plugins --skill tech-debt -a claude-code. Скилл окажется в ~/.claude/skills/tech-debt/SKILL.md.
Что делает tech-debt?
Находит технический долг, раскладывает его по категориям и считает приоритет по влиянию, риску и трудоёмкости. В ответ вы получаете упорядоченный список с планом исправления.
На каких платформах работает скилл?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой платформы своя команда установки.
Исходный текст
SKILL.md · Apache-2.0
--- name: tech-debt description: Identify, categorize, and prioritize technical debt. Trigger with "tech debt", "technical debt audit", "what should we refactor", "code health", or when the user asks about code quality, refactoring priorities, or maintenance backlog. --- # Tech Debt Management Systematically identify, categorize, and prioritize technical debt. ## Categories | Type | Examples | Risk | |------|----------|------| | **Code debt** | Duplicated logic, poor abstractions, magic numbers | Bugs, slow development | | **Architecture debt** | Monolith that should be split, wrong data store | Scaling limits | | **Test debt** | Low coverage, flaky tests, missing integration tests | Regressions ship | | **Dependency debt** | Outdated libraries, unmaintained dependencies | Security vulns | | **Documentation debt** | Missing runbooks, outdated READMEs, tribal knowledge | Onboarding pain | | **Infrastructure debt** | Manual deploys, no monitoring, no IaC | Incidents, slow recovery | ## Prioritization Framework Score each item on: - **Impact**: How much does it slow the team down? (1-5) - **Risk**: What happens if we don't fix it? (1-5) - **Effort**: How hard is the fix? (1-5, inverted — lower effort = higher priority) Priority = (Impact + Risk) x (6 - Effort) ## Output Produce a prioritized list with estimated effort, business justification for each item, and a phased remediation plan that can be done alongside feature work.
© anthropics · Apache-2.0 · anthropics/knowledge-work-plugins