用途:审计仓库中的超长源码文件,只返回物理行数达到或超过阈值的文件,便于定位需要拆分或重构的大文件。
主要能力:先应用仓库 .gitignore,再应用额外 exclude 规则;使用一个或多个 include glob 限定扫描范围;输出超阈值文件列表及行数,例如 src/example.ts 512。支持嵌套 .gitignore。
使用方式:先安装,命令为 npx skills add bosens-China/my-skills/skills/file-line-audit。随后从 scripts/ 目录按平台选择二进制,如 scripts/line-audit-windows-amd64.exe、scripts/line-audit-linux-amd64、scripts/line-audit-linux-arm64、scripts/line-audit-darwin-amd64、scripts/line-audit-darwin-arm64。Linux/macOS 下需 chmod +x <binary_path>。务必在目标仓库根目录运行,使 .gitignore 正确生效。先查看仓库结构与语言栈决定扫描范围,再通过命令行显式传入参数,没有默认配置文件。
常用参数:--include / -i 必填 glob,可重复;--exclude / -e 可选,语法同 .gitignore,可重复;--threshold / -t 输出阈值,默认 400;--json / -j 传入含 threshold、include、exclude 的 JSON 对象;--help / -h 显示帮助。Windows 命令写法与 Unix 略有差异,需使用对应可执行文件。
适用场景:识别源码目录如 src、app、apps、pkg、packages、lib、internal、cmd、backend、frontend、client、server、service、services、api、web,以及相关源码扩展名如 js、ts、tsx、vue、py、go、rs、java、kt、rb、php、cs、swift;仅在 .gitignore 不足时补充 dist/、build/、coverage/ 或生成目录。
限制:只统计物理行数,不区分代码、注释或空行;自动跳过二进制文件;依赖 Git 环境解析 .gitignore;面向源码扫描优化,避免扫描未被 .gitignore 覆盖的大型数据目录或构建产物;每次运行至少需要一个 --include 模式。