Agent Skills
返回列表
💻

CodeClimate 可维护性追踪器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/codeclimate-maintainability-tracker-7。

技能介绍

要解决的问题

维护性指标只存在于 CodeClimate 面板上时，几乎无法用于工程决策。你想知道某个模块的评分是近几周缓慢下滑，还是某次重构后突然跳水——靠肉眼翻页面很难回溯。更现实的痛点是：技术债务往往集中在少数“改得多、又改得复杂”的文件里，没有结构化跟踪，这些热点只能靠评审时的直觉发现。

核心能力

这个技能围绕 Code Climate v1 API 做了三件事：

  • 历史跟踪：拉取可维护性评分随时间的变化，把面板上的单点数值变成可对比的时间序列，而不是每次打开页面看一个快照。
  • 债务热点识别：定位评分偏低或持续恶化的文件，帮你把有限的重构预算集中到真正拖后腿的位置。
  • 变更-复杂度耦合监控：关注那些“改动频繁且复杂度高”的代码区域，这类文件是评分恶化的高发地带，也是评审时最容易被忽略的风险点。

在输出侧，它通过 SendGrid 发送每周摘要，把一周内的评分变化、热点清单汇总成邮件，团队不必主动登录平台查看。

适用边界

  • 能力范围限定在可维护性（Maintainability）评分这一指标上，不涉及 CodeClimate 的覆盖率、linting 或其他维度的分析，也不做代码质量的全面扫描。
  • 历史数据的粒度取决于 v1 API 的返回内容：评分变化依赖已有的跟踪数据积累，新接入的仓库前期没有历史可比，趋势要跑一段时间后才有参考价值。
  • 每周摘要依赖 SendGrid 的配置，发送链路（API 凭证、收件人列表）需要自行准备好，技能本身不负责邮件账户的设置。

参考文档：https://docs.codeclimate.com/docs/the-code-page

使用场景

  • 重构完成后，需要确认某个模块的 CodeClimate 可维护性评分是否持续下滑，而不是只看改完后的单次快照。
  • 每周例会前，需要把代码库中评分最低的文件整理成清单，据此安排本周的重构优先级。
  • 准备做技术债务治理时，需要找出改动频繁且复杂度高的文件，这些是评分恶化风险最大的区域。
  • 团队希望每周自动收到一份可维护性变化摘要，不用有人手动登录 CodeClimate 面板逐项查看。

适合人员

  • 技术负责人或架构师，需要长期追踪代码可维护性趋势，为重构和债务治理提供数据依据。
  • 后端工程师，想在提交代码时了解哪些文件评分偏低，避免在技术债务密集区继续堆改动。
  • 工程效能团队成员，负责搭建自动化指标报告链路，让团队每周自动收到可维护性摘要邮件。
  • 负责技术债务专项治理的开发组长，需要按评分恶化程度圈定重构范围并追踪治理效果。