@josephyoung/pi-file-reference
自动解析并注入AGENTS.md中的文件引用到系统提示词
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@josephyoung/pi-file-reference。 它的用途是：自动解析并注入AGENTS.md中的文件引用到系统提示词 完整的 Skill 内容见：https://321skill.com/skills/josephyoung-pi-file-reference/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请根据项目配置和API文档，设计一个新的用户认证模块。” 它会自动将你在AGENTS.md中通过`@./project-config.yaml`和`@./api-specs/`引用的所有文件内容作为背景知识，从而给出更贴合项目现状的代码建议或架构设计。
介绍
这个Skill解决了在编写AGENTS.md时，需要手动复制粘贴大量文件内容到系统提示词中的繁琐问题。它通过识别AGENTS.md中的@filepath标记，自动读取并解析指定文件或目录的内容，然后将其注入到Claude等AI助手的系统提示词中，极大地简化了上下文构建过程。
使用方式非常直接。用户只需在AGENTS.md文件中，使用类似@./config.json或@./docs/的语法标记需要引用的文件或目录路径。当启动AI助手并加载此Skill后，它会自动处理这些标记，将对应内容无缝整合到系统提示里，无需任何额外操作。
它非常适合需要为AI助手提供复杂、结构化项目背景的开发者、技术文档工程师或项目管理者。例如，在开发一个拥有多个配置文件和API文档的新项目时，此工具能确保AI对项目有全面、准确的了解。
建议在项目根目录的AGENTS.md中清晰组织文件引用，并确保引用的文件路径正确。注意，它处理的是文本内容，对于二进制文件或极大型文件可能不适用，应优先引用关键的配置文件、API说明或架构文档。
核心特点
与同类Skill相比，它专注于自动化处理AGENTS.md中的文件引用语法，实现了从标记到系统提示词注入的无缝流水线，而不仅仅是简单的文件读取。它支持目录引用，能递归处理目录下的文件，提供了更完整的项目上下文构建能力。
注意事项
不适合处理二进制文件、体积过大的文件，或者在非Pi扩展环境下使用。
常见问题
支持哪些文件路径格式？
支持相对路径（如`@./file.txt`）和目录路径（如`@./src/`），目录会递归包含其下文件。
注入的内容会影响AI的token消耗吗？
会，所有被引用的文件内容都会作为系统提示词的一部分，计入token消耗。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/josephyoung-pi-file-reference/raw/index.md 读取 @josephyoung/pi-file-reference 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/josephyoung-pi-file-reference/raw/index.md（查看排版版本）