AGENT SKILL

tech-debt-tracker

Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.

License 许可
MIT
最近更新
2026-03-13
Stars
★ 4
Forks
0

01 前言 Front Matter

name
tech-debt-tracker
description
Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.

02 资源文件 17

03 SKILL.md 正文

Tech Debt Tracker

Tier: POWERFUL ?
Category: Engineering Process Automation
Expertise: Code Quality, Technical Debt Management, Software Engineering

Overview

Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases.

Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated dependencies, documentation gaps, and infrastructure compromises. Like financial debt, it accrues "interest" through increased development time, higher bug rates, and reduced team velocity.

What This Skill Provides

This skill offers three interconnected tools that form a complete tech debt management system:

  1. Debt Scanner - Automatically identifies tech debt signals in your codebase
  2. Debt Prioritizer - Analyzes and prioritizes debt items using cost-of-delay frameworks
  3. Debt Dashboard - Tracks debt trends over time and provides executive reporting

Together, these tools enable engineering teams to make data-driven decisions about tech debt, balancing new feature development with maintenance work.

Technical Debt Classification Framework

→ See references/debt-frameworks.md for details

Implementation Roadmap

Phase 1: Foundation (Weeks 1-2)

  1. Set up debt scanning infrastructure
  2. Establish debt taxonomy and scoring criteria
  3. Scan initial codebase and create baseline inventory
  4. Train team on debt identification and reporting

Phase 2: Process Integration (Weeks 3-4)

  1. Integrate debt tracking into sprint planning
  2. Establish debt budgets and allocation rules
  3. Create stakeholder reporting templates
  4. Set up automated debt scanning in CI/CD

Phase 3: Optimization (Weeks 5-6)

  1. Refine scoring algorithms based on team feedback
  2. Implement trend analysis and predictive metrics
  3. Create specialized debt reduction initiatives
  4. Establish cross-team debt coordination processes

Phase 4: Maturity (Ongoing)

  1. Continuous improvement of detection algorithms
  2. Advanced analytics and prediction models
  3. Integration with planning and project management tools
  4. Organization-wide debt management best practices

Success Criteria

Quantitative Metrics:

  • 25% reduction in debt interest rate within 6 months
  • 15% improvement in development velocity
  • 30% reduction in production defects
  • 20% faster code review cycles

Qualitative Metrics:

  • Improved developer satisfaction scores
  • Reduced context switching during feature development
  • Faster onboarding for new team members
  • Better predictability in feature delivery timelines

Common Pitfalls and How to Avoid Them

1. Analysis Paralysis

Problem: Spending too much time analyzing debt instead of fixing it. Solution: Set time limits for analysis, use "good enough" scoring for most items.

2. Perfectionism

Problem: Trying to eliminate all debt instead of managing it. Solution: Focus on high-impact debt, accept that some debt is acceptable.

3. Ignoring Business Context

Problem: Prioritizing technical elegance over business value. Solution: Always tie debt work to business outcomes and customer impact.

4. Inconsistent Application

Problem: Some teams adopt practices while others ignore them. Solution: Make debt tracking part of standard development workflow.

5. Tool Over-Engineering

Problem: Building complex debt management systems that nobody uses. Solution: Start simple, iterate based on actual usage patterns.

Technical debt management is not just about writing better code - it's about creating sustainable development practices that balance short-term delivery pressure with long-term system health. Use these tools and frameworks to make informed decisions about when and how to invest in debt reduction.

04 同仓库更多 Skills

zhangzhang-111-i
zhangzhang-111-i/claude-skills111

risk-management-specialist

Medical device risk management specialist implementing ISO 14971 throughout product lifecycle. Provides risk analysis, risk evaluation, risk control, and post-production information analysis. Use when user mentions risk management, ISO 14971, risk analysis, FMEA, fault tree analysis, hazard identification, risk control, risk matrix, benefit-risk analysis, residual risk, risk acceptability, or post-market risk.

★ 4
zhangzhang-111-i
zhangzhang-111-i/claude-skills111

regulatory-affairs-head

Senior Regulatory Affairs Manager for HealthTech and MedTech companies. Prepares FDA 510(k), De Novo, and PMA submission packages; analyzes regulatory pathways for new medical devices; drafts responses to FDA deficiency letters and Notified Body queries; develops CE marking technical documentation under EU MDR 2017/745; coordinates multi-market approval strategies across FDA, EU, Health Canada, PMDA, and NMPA; and maintains regulatory intelligence on evolving standards. Use when users need to plan or execute FDA submissions, navigate 510(k) or PMA approval processes, achieve CE marking, prepare pre-submission meeting materials, write regulatory strategy documents, respond to agency queries, or manage compliance documentation for medical device market access.

★ 4
zhangzhang-111-i
zhangzhang-111-i/claude-skills111

quality-manager-qms-iso13485

ISO 13485 Quality Management System implementation and maintenance for medical device organizations. Provides QMS design, documentation control, internal auditing, CAPA management, and certification support. Use when working with medical device quality systems, preparing for ISO 13485 audits, managing regulatory compliance documentation, setting up corrective actions, or building audit preparation programs. Useful for quality management, audit preparation, regulatory compliance, medical device documentation, and corrective action workflows.

设计师视觉设计
★ 4
zhangzhang-111-i
zhangzhang-111-i/claude-skills111

quality-manager-qmr

Senior Quality Manager Responsible Person (QMR) for HealthTech and MedTech companies. Provides quality system governance, management review leadership, regulatory compliance oversight, and quality performance monitoring per ISO 13485 Clause 5.5.2.

律师与法务
★ 4
zhangzhang-111-i
zhangzhang-111-i/claude-skills111

quality-documentation-manager

Document control system management for medical device QMS. Covers document numbering, version control, change management, and 21 CFR Part 11 compliance. Use for document control procedures, change control workflow, document numbering, version management, electronic signature compliance, or regulatory documentation review.

律师与法务文档处理
★ 4
zhangzhang-111-i
zhangzhang-111-i/claude-skills111

qms-audit-expert

ISO 13485 internal audit expertise for medical device QMS. Covers audit planning, execution, nonconformity classification, and CAPA verification. Use for internal audit planning, audit execution, finding classification, external audit preparation, or audit program management.

★ 4