Technical Debt Remediation Plan — субагент для GitHub Copilot
Составляет пошаговые планы устранения техдолга в кодовой базе. Пригодится, когда нужно разобрать накопившиеся TODO или устаревшие зависимости без риска сломать прод.
.github/agents/tech-debt-remediation-plan.agent.mdЧто делает Technical Debt Remediation Plan
Субагент работает только в режиме анализа. Он находит проблемные зоны в коде, включая отсутствие тестов, устаревшую документацию, высокую связанность и теги FIXME. Результат выдаётся в виде сводной таблицы и детального плана действий с шагами реализации и методами проверки.
Каждая проблема оценивается по шкале от 1 до 5. Субагент фиксирует сложность исправления и влияние на качество кодовой базы. Риск бездействия оценивается отдельно с цветовыми метками. Инструмент умеет искать существующие тикеты через search_issues и готовить задачи по шаблону /.github/ISSUE_TEMPLATE/chore_request.yml.
Ставьте его для планирования спринта по рефакторингу. Если же вы ждёте, что агент сам перепишет проблемный код, этот субагент не подойдёт.
Какие задачи решает
- составить план рефакторинга устаревших зависимостей и вызовов API
- оценить риски и сложность проблемных участков кода по шкале от 1 до 5
- оформить задачи по шаблону chore_request.yml с привязкой к issues
- найти пробелы в тестовом покрытии и устаревшую документацию
Примеры запросов агенту
- Составь план устранения техдолга для модулей авторизации с оценкой рисков.
- Найди все метки TODO и FIXME в проекте и оформи задачи для GitHub Issues.
- Оцени устаревшие зависимости и распиши шаги проверки после их обновления.
Как установить Technical Debt Remediation Plan
Вручную: положить файлы
.github/agents/tech-debt-remediation-plan.agent.mdВручную: положить файлы
.claude/agents/tech-debt-remediation-plan.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code
Вручную: положить файлы
.codex/agents/tech-debt-remediation-plan.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/tech-debt-remediation-plan.mdCursor понимает и .claude/agents/
Из того же набора554
Весь набор →Похожие
Вопросы о Technical Debt Remediation Plan
Как установить Technical Debt Remediation Plan?
Для Claude Code сохраните конфигурацию по пути .claude/agents/tech-debt-remediation-plan.md. В Cursor используйте файл .cursor/agents/tech-debt-remediation-plan.md, а в Codex — .codex/agents/tech-debt-remediation-plan.md.
Меняет ли субагент код в репозитории?
Нет, он работает исключительно в режиме анализа. Субагент формирует структурированные списки задач и оценки, не внося правок в файлы проекта.
Как субагент оценивает найденный техдолг?
Он использует шкалу от 1 до 5 для оценки простоты исправления, влияния на качество и рисков. Для визуализации уровня риска применяются цветные индикаторы.
Исходный текст
tech-debt-remediation-plan.agent.md · MIT
--- description: 'Generate technical debt remediation plans for code, tests, and documentation.' name: 'Technical Debt Remediation Plan' tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github'] --- # Technical Debt Remediation Plan Generate comprehensive technical debt remediation plans. Analysis only - no code modifications. Keep recommendations concise and actionable. Do not provide verbose explanations or unnecessary details. ## Analysis Framework Create Markdown document with required sections: ### Core Metrics (1-5 scale) - **Ease of Remediation**: Implementation difficulty (1=trivial, 5=complex) - **Impact**: Effect on codebase quality (1=minimal, 5=critical). Use icons for visual impact: - **Risk**: Consequence of inaction (1=negligible, 5=severe). Use icons for visual impact: - 🟢 Low Risk - 🟡 Medium Risk - 🔴 High Risk ### Required Sections - **Overview**: Technical debt description - **Explanation**: Problem details and resolution approach - **Requirements**: Remediation prerequisites - **Implementation Steps**: Ordered action items - **Testing**: Verification methods ## Common Technical Debt Types - Missing/incomplete test coverage - Outdated/missing documentation - Unmaintainable code structure - Poor modularity/coupling - Deprecated dependencies/APIs - Ineffective design patterns - TODO/FIXME markers ## Output Format 1. **Summary Table**: Overview, Ease, Impact, Risk, Explanation 2. **Detailed Plan**: All required sections ## GitHub Integration - Use `search_issues` before creating new issues - Apply `/.github/ISSUE_TEMPLATE/chore_request.yml` template for remediation tasks - Reference existing issues when relevant
© github · MIT · github/awesome-copilot