@bytesbrains/pi-auditor
审计代码仓库文件，优化RAG内容可读性。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@bytesbrains/pi-auditor。 它的用途是：审计代码仓库文件，优化RAG内容可读性。 完整的 Skill 内容见：https://321skill.com/skills/bytesbrains-pi-auditor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用 pi-auditor 分析当前目录下的项目文件，找出可能影响RAG检索效果的‘上帝文件’。” 它会扫描项目，生成一份报告，列出问题文件、碎片化指标，并给出具体的文件拆分或重组建议，帮助你为RAG系统准备更高质量的知识源。
介绍
pi-auditor 是一款专为提升检索增强生成（RAG）系统内容质量而设计的审计工具。它主要解决开发者在构建RAG知识库时，因源代码文件结构复杂、内容冗长或碎片化导致的检索效果不佳问题。
该工具通过扫描和分析代码仓库中的文件，自动识别出内容过于庞大、难以被有效分割和检索的“上帝文件”，并量化评估现有代码块的分割碎片化程度。它不仅能发现问题，还能提供具体的文件拆分建议，帮助优化知识库结构。
它非常适合AI应用开发者、机器学习工程师以及任何需要将代码库作为知识源接入RAG系统的团队。无论是构建内部知识问答助手，还是开发面向代码的智能搜索工具，都可以使用它来预处理和优化知识源。
使用建议：在将代码库导入RAG系统前，先运行此工具进行审计。根据其生成的报告，优先拆分建议中的“上帝文件”，并调整代码块的分割策略（如按函数、类或逻辑模块），以获得更精准的检索结果。注意，它主要分析文件结构和内容分布，不涉及代码逻辑正确性检查。
核心特点
与通用代码质量扫描工具不同，它专门针对RAG系统的知识源可读性进行量化审计，能精准定位导致检索碎片化的“上帝文件”并提供拆分建议，而非仅仅检查代码风格或漏洞。
注意事项
该工具主要关注文件结构和内容分割，不适合用于检查代码的业务逻辑错误或安全漏洞。
常见问题
pi-auditor 能检查哪些类型的文件？
主要针对代码仓库中的文本文件（如.py, .js, .md等）进行结构和内容分析。
它如何定义“上帝文件”？
通常指内容过长、过于复杂，导致在RAG中难以被有效分割和检索的单个文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/bytesbrains-pi-auditor/raw/index.md 读取 @bytesbrains/pi-auditor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/bytesbrains-pi-auditor/raw/index.md（查看排版版本）