codebase-inspection

codebase-inspection 技能提供了一个强大的接口，利用 pygount 工具来衡量软件项目的指标。它专为需要了解代码库结构组成、实际大小及文档密度的开发人员、项目经理与审计人员所设计。通过产生代码行数 (LOC)、各语言文件计数以及可执行代码与注释比例的详细摘要，它能协助团队追踪技术债、验证项目规模并执行存储库审计。此技能在接手新项目、准备代码审查或对复杂单体存储库进行高阶分析时特别有用。

• 自动计算整个存储库或特定子目录的总代码行数、空白行数及注释行数。

• 产生语言特定的分布报告，以识别项目的技术栈与主导语言。

• 提供代码与注释比例的细部可见性，协助评估文档质量与维护健康度。

• 支持多种输出格式，包括人类可读的摘要与供后续处理使用的 JSON 格式。

• 内置预先设定的文件夹排除逻辑，可安全地忽略 node_modules、venv 和 .git 等依赖目录，避免处理程序挂起。

• 请务必使用 --folders-to-skip 参数过滤掉构建产物、包依赖及版本控制文件，以确保执行快速且准确。

• 当针对大型单体存储库时，可使用 --suffix 参数指定特定编程语言，以缩小分析范围。

• 解析摘要输出中的“伪语言”(pseudo-languages)，例如 binary、generated 及 duplicate，以准确理解引擎如何分类文件。

• 请注意，Markdown 等文档导向格式会被 pygount 分类为注释，导致代码行数为零；若有需要，针对纯文本文件可搭配 wc 等补充工具使用。

• 确保 pygount 工具已安装在代理程序的环境中；该技能为各种 Linux/macOS 环境提供了备用安装指令。