Analyze and Reduce Technical Debt Skill 技能

技能简介

Analyze and Reduce Technical Debt 是 sickn33 发布在 Skillstore 的技术债务专项治理技能，质量评分 78/100。它把"技术债务"从模糊的口头抱怨变成可量化的资产——识别债务类型、估算成本、量化影响、输出 ROI 预测，最终落地为可执行的清理 backlog。对于管理者来说，它能生成给 stakeholder 看的高管报告；对于开发者来说，它能给出具体的优先级排序和实施路径。

核心能力

• 全维度债务盘点：覆盖 5 大类技术债务——代码债务（重复逻辑、复杂函数）、架构债务（坏耦合、错层抽象）、测试债务（覆盖率不足、脆弱用例）、文档债务（缺失 ADR、过时注释）、基础设施债务（陈旧依赖、脆弱 CI），系统性避免遗漏。
• 三维度影响估算：每个债务项都按"研发效率影响"、"质量风险影响"、"规划可行性影响"三个维度量化打分，输出综合优先级。
• 债务仪表盘：自动汇总关键指标——圈复杂度均值、代码重复率、测试覆盖率、依赖健康度、文档完整度，让债务现状可视化。
• 优先级三段式：把清理任务分为"速胜项（1-3 天）"、"中期项目（1-2 周）"、"长期计划（季度级）"，便于塞入不同节奏的工作计划。
• 预防性门禁：定义 commit / CI / Code Review / 债务预算四类质量门禁，从源头控制新债务产生。
• ROI 预测 + Stakeholder 简报：基于历史缺陷率、变更频率、人天成本估算月度损失金额，给出清理后的预期回报，并自动生成给老板看的高管摘要。

安装配置

# 方式一：通过 Skillstore CLI 安装
npx skillstore add sickn33/code-refactoring-tech-debt

# 方式二：手动克隆 GitHub 仓库
git clone https://github.com/sickn33/antigravity-awesome-skills.git
cd antigravity-awesome-skills/skills/code-refactoring-tech-debt

# 方式三：在 Claude Code 中通过 marketplace 添加
claude plugin add sickn33/code-refactoring-tech-debt

安装前需要准备好：仓库源码访问权限、最近 6 个月的缺陷/事故数据、团队平均人天成本估算（用于 ROI 计算）、覆盖率报告（如 coverage.xml）。

使用步骤

1. 数据收集：提供仓库地址、测试覆盖率报告、最近 N 个月的 incident log、依赖版本清单。
2. 债务扫描：调用技能，Agent 按五大类逐一盘点，输出初步债务清单（每项含位置、类型、严重度）。
3. 影响估算：Agent 对每个债务项打分——影响哪些功能模块、改动频率、未来 6 个月的风险概率。
4. 成本量化：根据缺陷率 × 修复时间 × 人天成本，估算每个债务项的月度持有成本。
5. 优先级排序：按"价值/成本"比排序，输出速胜 / 中期 / 长期三段式 backlog，每项含 effort、expected benefit、risk、owners、acceptance criteria。
6. 生成报告：输出三份文档——给 stakeholder 的高管摘要（成本 + ROI）、给开发者的实施指南、给项目经理的甘特图输入。

适用场景

• 重构 Sprint 规划：把债务清单转成下个 Sprint 的可执行工单，让团队专注高价值清理。
• 遗留系统评估：在接手新项目或评估并购目标代码资产时，快速量化"代码质量风险"。
• 高管汇报：每季度给 CEO/CTO 输出一份"技术债务现状与改进路线图"，把抽象的技术债变成具体的美元数字。
• CI/CD 集成：把预防性门禁嵌入 CI 流水线，自动拦截新增的低质量代码。
• 跨团队对标：在多个团队/产品线之间横向比较债务水平，识别最佳实践和薄弱环节。

适用人群

• 技术总监 / VP Engineering
• 负责技术规划的架构师 / Tech Lead
• 在 Sprint 规划中需要优先级建议的 PM
• 想要量化"代码质量"以获得预算支持的工程经理
• 关注工程效能（Engineering Productivity）方向的平台团队

工作原理

该技能本质是"财务思维 + 工程实践"的桥接工具。它不直接修改代码，而是引导 Agent：先把分散的代码问题归类到 5 个标准化维度；再用成本公式（缺陷数 × 修复时间 × 时薪 + 机会成本）量化每个债务项的"持有成本"；最后按 ROI 排序输出 backlog。所有估算都依赖用户提供的数据，技能本身不会编造数字——它强调"假设要标注 + 信心度要分级"。最终输出三份结构化文档（高管摘要 / 开发者指南 / PM 排期），让不同角色都能各取所需。

官方链接

• 技能页面：https://skillstore.io/skills/sickn33-code-refactoring-tech-debt
• Markdown 源：https://skillstore.io/skills/sickn33-code-refactoring-tech-debt.md
• Manifest：https://skillstore.io/api/skills/sickn33-code-refactoring-tech-debt/manifest
• 作者主页：https://github.com/sickn33
• 仓库位置：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/code-refactoring-tech-debt