前言¶
仓库越老，「先顶着上线、以后再 refactor」的注释往往越多。人工做代码审查能盯住局部坏味道，却很难在一次评审里同时覆盖架构分层、依赖版本和安全面，更少见把问题按「严重度 × 修复成本」排成可执行的偿还计划。下面介绍 SkillHub 社区 Skill「技术债务诊断分析器」：在 Agent 对话里扫描本地仓库或粘贴片段，按四类债务归类、排序，并输出分阶段路线图。
这是什么¶
技术债务诊断分析器（坐标 @user_f37e97ba/technical-debt-diagnostic，版本 1.0.0）是面向开发团队与技术管理者的代码质量诊断 Skill。发布者为 SkillHub 用户 user_f37e97ba，来源为 community，分类为 dev-programming；页面标注 requires_api_key=false，无需额外 API Key。
它解决的核心问题是：把分散在代码气味、架构、依赖与安全里的技术债一次性结构化，而不是只给零散修改建议。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装启用后由 Agent 按 SKILL 指引执行。
- 代码仓库扫描：自动遍历目录，定位问题代码；也支持直接粘贴代码片段分析。
- 四大类债务识别：
- 代码气味（Code Smell）
- 架构腐化
- 依赖风险
- 安全漏洞 - 严重度 × 修复成本矩阵排序：优先标出高影响、相对低成本可先做的项。
- 偿还路线图：分阶段修复计划，含预估工时。
- 影响量化：从开发速度损耗、Bug 率、系统稳定性等维度评估债务影响。
官方强调的适用方向包括：代码健康度体检、重构规划、技术评审、新项目技术选型。
安装与启用¶
SkillHub 页面给出的安装方式，是让 AI 按统一安装文档拉取指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f37e97ba/technical-debt-diagnostic。
在 Cursor、Codex CLI、Claude Code 等支持 SkillHub 安装流的客户端中，把上述提示发给 Agent 即可；具体目录与配置字段以 skillhub.md 为准。本 Skill 未要求 API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_f37e97ba/technical-debt-diagnostic
- API 地址：https://api.skillhub.cn/user_f37e97ba/technical-debt-diagnostic
典型用法¶
安装完成后，在已打开目标仓库的工作区里，用自然语言触发分析即可。官方资料列出的触发表述包括：
- 「技术债务分析」「技术债」「代码质量评估」
technical debt、代码健康度、代码坏味道- 「架构腐化」「依赖风险分析」「重构方案」「代码审查」
可按场景选择输入方式：
- 全仓扫描：说明要分析当前仓库（或指定子目录），请 Agent 按 Skill 遍历并归类问题。
- 片段分析：粘贴关键模块或 PR diff，聚焦某块代码的债务类型与优先级。
- 要路线图：在触发语中明确要求「按严重度 × 成本排序」和「分阶段偿还计划含工时」，以对齐 Skill 的矩阵排序与路线图输出。
下列情形通常不应指望本 Skill 单独承担（与官方触发边界一致）：纯性能调优、功能需求评审、单个 Bug 修复、逐行代码解释。这类任务应换用对应 Skill 或普通对话。
适用场景与注意¶
适合谁
- 技术负责人要在评审前做「体检报告」，给排期和资源讨论用。
- 维护期项目准备大规模重构，需要先有一张按优先级排列的债项清单。
- 新项目选型或合并代码库后，快速扫依赖与安全、架构层面的风险。
使用上需注意
- 输出依赖 Agent 对仓库的访问范围；扫描大仓时建议在对话里限定路径或模块，避免一次上下文过载。
- 影响量化与工时预估是 Skill 设计的输出形态，实际数值仍应结合团队基线人工校准，不宜直接当作排期承诺。
- 社区来源（community）、当前页面统计为评分 100000、下载 635；能力与边界以 v1.0.0 页面说明为准。
结尾¶
技术债务诊断分析器把「扫仓库 / 贴代码 → 四类归类 → 矩阵排序 → 路线图与影响量化」串成一条可在 Agent 里复用的流程，适合在重构和技术评审前先做结构化诊断。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_f37e97ba/technical-debt-diagnostic
