技能 codebase-cleanup-tech-debt
📊

codebase-cleanup-tech-debt

安全

Анализ и снижение технического долга

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

支持: Claude Codex Code(CC)
📊 71 充足
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“codebase-cleanup-tech-debt”。 Analyze my Ruby on Rails codebase for technical debt

预期结果:

## Technical Debt Analysis

### Key Findings
- **Critical**: 3 God classes in app/models (500+ lines each)
- **High**: 23% code duplication in validation logic
- **Medium**: Test coverage at 45% (target: 80%)

### Top Quick Wins
1. Extract duplicate validation to shared module (8 hours, saves 20 hours/month)
2. Add error monitoring to payment service (4 hours, saves 15 hours/month)

### Recommended Roadmap
- **Month 1**: Quick wins + begin OrderService refactor
- **Month 2-3**: Complete refactoring + upgrade Rails version
- **Quarter 2**: Comprehensive test coverage improvement

正在使用“codebase-cleanup-tech-debt”。 Create a debt prevention strategy for our team

预期结果:

## Debt Prevention Strategy

### Automated Gates
- Pre-commit: Complexity check (max 10), duplication check (max 5%)
- CI: Dependency audit, performance regression tests
- Code Review: Two approvals, tests required, documentation required

### Debt Budget
- Allowed monthly increase: 2%
- Mandatory quarterly reduction: 5%
- Tracking tools: SonarQube, Dependabot, CodeCov

### Success Metrics
- Monthly: Debt score reduction target -5%
- Quarterly: Architecture health score, developer satisfaction

安全审计

安全
v1 • 2/25/2026

All 30 static findings evaluated as false positives. The skill is purely instructional content for technical debt analysis. Dollar amounts in examples ($150/hour) were misidentified as shell commands. Generic technical terms were misidentified as cryptographic algorithms. Prevention planning was misidentified as system reconnaissance. No actual security risks present.

1
已扫描文件
389
分析行数
0
发现项
1
审计总数
未发现安全问题

检测到的模式

Dollar Amount Examples MisidentifiedGeneric Terms Misidentified as Cryptographic AlgorithmsPrevention Planning Misidentified
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
32
社区
100
安全
91
规范符合性

你能构建什么

Первоначальная оценка долга

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

Поддержка планирования спринта

Выявлять быстрые победы и задачи рефакторинга с высоким ROI для включения в предстоящие сессии планирования спринта.

Коммуникация со стейкхолдерами

Генерировать резюме для руководства и прогнозы ROI для обоснования инвестиций в устранение технического долга перед бизнес-руководством.

试试这些提示

Быстрое сканирование долга 
Analyze my codebase for technical debt. Focus on finding: duplicated code patterns, high complexity functions, missing tests, and outdated dependencies. List the top 10 debt items with estimated remediation effort.
Комплексный аудит долга 
Conduct a full technical debt audit of our codebase. Include: code debt (duplication, complexity, structure), architecture debt (design flaws, tech stack), testing debt (coverage, quality), documentation debt, and infrastructure debt. For each category, quantify the impact and create a prioritized remediation plan.
ROI-ориентированная приоритезация 
Calculate the ROI for our top 20 technical debt items. For each, estimate: developer time lost per month, bug rate impact, and onboarding delay. Rank by highest ROI opportunity and create a quarterly remediation roadmap.
Стратегия предотвращения долга 
Design a debt prevention strategy for our team. Include: pre-commit hooks for code quality, CI pipeline gates, code review requirements, and a debt budget policy. Explain how to track compliance and measure success.

最佳实践

  • Начинайте с быстрых побед, которые показывают немедленный ROI, чтобы заручиться поддержкой команды для более крупных усилий по рефакторингу
  • Всегда количественно оценивайте влияние долга в часах разработчиков и валюте для эффективной коммуникации со стейкхолдерами
  • Используйте feature flags для постепенного рефакторинга, чтобы снизить риск и позволить инкрементальную доставку ценности

避免

  • Попытка исправить весь долг сразу — приоритезируйте на основе влияния и усилий для устойчивого прогресса
  • Игнорирование долга тестирования — низкое покрытие усугубляет все другие типы долга и замедляет будущие изменения
  • Отсутствие отслеживания долга во времени — без метрик команды не могут измерить улучшение или регресс

常见问题

Какие типы технического долга анализирует этот навык?
Навык анализирует пять основных категорий: долг кода (дублирование, сложность, структура), долг архитектуры (ошибки проектирования, технологический стек), долг тестирования (пробелы в покрытии, качество тестов), долг документации (отсутствие документации, устаревшие руководства) и долг инфраструктуры (проблемы развёртывания, пробелы в мониторинге).
Вносит ли этот навык изменения в мою кодовую базу?
Нет. Этот навык предоставляет анализ, рекомендации и руководства. Он не выполняет никаких изменений кода. Вся работа по рефакторингу должна выполняться вручную или с помощью других инструментов.
Как навык рассчитывает ROI для устранения долга?
ROI рассчитывается путём оценки времени, сэкономленного в месяц от исправления долга, умноженного на почасовую ставку разработчика, в сравнении с усилиями, необходимыми для реализации исправления. Ставка по умолчанию — $150/час, но может быть скорректирована.
Может ли этот навык работать с любым языком программирования?
Да. Навык предоставляет фреймворк для анализа долга, который не зависит от языка. Конкретные упомянутые метрики и инструменты могут быть адаптированы к любому технологическому стеку.
Как часто нам следует запускать анализ технического долга?
Команды должны проводить комплексный анализ ежеквартально, с ежемесячными быстрыми сканированиями для отслеживания прогресса. После крупных релизов или значительного рефакторинга дополнительный анализ помогает выявить новое накопление долга.
Что такое бюджет долга и как его внедрить?
Бюджет долга ограничивает, сколько нового долга может быть введено за квартал (обычно 2-5%). Он требует от команд исправления существующего долга перед добавлением нового. Реализация использует автоматизированные инструменты для отслеживания метрик сложности, дублирования и покрытия.

开发者详情

作者

sickn33

许可证

MIT

仓库

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/codebase-cleanup-tech-debt

引用

main

文件结构

📄 SKILL.md