From holger
对 Git 仓库进行快速健康诊断,在阅读代码之前先了解代码库的整体状况。 当用户提到"代码库诊断"、"代码库体检"、"代码库健康检查"、"codebase diagnosis"、"codebase audit"、 "分析代码库"、"了解代码库"、"代码库概况"、"仓库分析"、"git 分析"、"git 诊断"、 "谁写的代码"、"哪些文件改动最多"、"bug 集中在哪里"、"项目是否健康"时使用此 skill。 也适用于用户刚接手一个新项目、想快速了解代码库现状的场景。
How this skill is triggered — by the user, by Claude, or both
Slash command
/holger:git-codebase-diagnosisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
在阅读任何一个代码库之前,通过 Git 提交历史对代码库进行快速"体检"。这个技能基于 Ally Piechowski 的文章 *The Git Commands I Run Before Reading Any Code* 整理而来,用 5 个维度帮你快速了解一个代码库的健康状况。
在阅读任何一个代码库之前,通过 Git 提交历史对代码库进行快速"体检"。这个技能基于 Ally Piechowski 的文章 The Git Commands I Run Before Reading Any Code 整理而来,用 5 个维度帮你快速了解一个代码库的健康状况。
运行 scripts/diagnose.sh 脚本收集所有原始数据,然后对结果进行分析和解读。
bash <skill-path>/scripts/diagnose.sh
脚本会依次执行以下 5 项检查,并将结果输出到终端。
找出过去一年中改动最频繁的 20 个文件。
排在前面的文件通常就是团队里大家"都怕碰"的那个。高频变更本身不是问题——活跃开发自然会带来高变更率。真正的风险信号是:一个文件频繁变更,但没人愿意认领它,每次修改都是补丁摞补丁,改动的影响范围难以预测。
分析时重点关注:
按提交数量排名所有贡献者,评估"巴士因子"——如果关键人物突然离开,项目会不会陷入危机。
分析时重点关注:
找出 Bug 相关提交(包含 fix、bug、broken 等关键词)集中的文件。
分析时重点关注:
按月统计提交数量,判断项目是在加速还是衰退。
分析时关注数据的"形状":
这是团队数据,不是代码数据——代码本身不会告诉你这些。
统计过去一年中 revert、hotfix、emergency、rollback 相关的提交。
解读方式:
危机模式一目了然——有就是有,没有就是没有。
完成所有 5 项检查后,输出一份结构化的诊断报告:
# 代码库诊断报告
## 概览
- 仓库名称:...
- 诊断时间:...
- 总提交数:...
- 总贡献者数:...
- 仓库历史跨度:...
## 1. 变更热点
[列出前 10 名文件及变更次数,标注哪些同时出现在 Bug 聚集区]
## 2. 贡献者分布
[列出主要贡献者,标注巴士因子风险等级]
## 3. Bug 聚集区
[列出前 10 名文件,标注与变更热点的交叉]
## 4. 项目趋势
[描述提交频率的变化趋势,给出判断]
## 5. 救火频率
[统计数量,给出评估]
## 综合评估
[基于以上 5 个维度的综合判断,指出最需要关注的 2-3 个风险点,
以及建议优先阅读的文件列表]
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub sleepy-zone/holger --plugin holger