代码库体检
对本地代码仓库跑统计,产出一份按语言分列的代码行、注释行、文件数和占比报告。
功能与用途
想评估一个仓库有多大、哪些语言是主体、代码与注释比例如何时,逐个目录数文件太费劲。这个 Skill 用 pygount 扫一遍仓库,给出按语言汇总的文件数、代码行、注释行和百分比,也能只看某几种语言或拉出单个文件的明细排序。它同时会提醒常见的坑:必须排除依赖和构建目录否则会长时间卡住、Markdown 会被算成注释、JSON 行数统计偏低要另用 wc -l。它给的是体量构成数据,不是代码质量评价。
适用场景
- 评估要不要接手或采购某个开源项目,先想知道它的体量、主要语言:评估要不要接手或采购某个开源项目,先想知道它的体量、主要语言和代码注释比例
- 给老板或客户汇报项目规模,需要一份按语言分列的代码行与文件数:给老板或客户汇报项目规模,需要一份按语言分列的代码行与文件数统计
- 做技术债梳理时想找出代码最多的若干文件,作为重点排查的候选:做技术债梳理时想找出代码最多的若干文件,作为重点排查的候选
- 接手一个多语言混合的仓库,想确认哪些语言是主体、值不值得按语:接手一个多语言混合的仓库,想确认哪些语言是主体、值不值得按语言拆开看
适用人群
- 软件工程师
- 技术负责人
- 研发效能工程师
使用步骤
- 给出要体检的仓库本地路径,并说明想看的范围(整体构成还是只统计某几种语言)
- 确认环境里装了 pygount,没有就先安装
- 执行统计时务必排除 .git、node_modules、venv、dist、build 等目录,避免爬依赖树卡住
- 拿到按语言汇总的表或逐文件明细;需要程序化处理时可要求输出 JSON 格式
- 结合特殊类别的含义读结果,比如重复文件、二进制文件和自动生成文件的比例
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-10
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Inspect codebases w/ pygount: LOC, languages, ratios.
使用前准备
- 需要命令行环境并安装 pygount(pip install pygount),仓库需在本地可访问
依赖与权限
- 读取用户主动提供的内容