@foxfirecodes/pi-agents-local-md
为Pi自动加载本地代理配置文件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@foxfirecodes/pi-agents-local-md。 它的用途是：为Pi自动加载本地代理配置文件 完整的 Skill 内容见：https://321skill.com/skills/foxfirecodes-pi-agents-local-md/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我启动代码审查代理。” 它会同时读取AGENTS.md中定义的标准代码审查流程和你AGENTS.local.md中添加的个人偏好规则（如忽略某些文件类型），从而提供更贴合你习惯的审查建议。当你需要临时调试一个API时，可以在.local文件中快速定义一个调试代理，而不会影响团队共享的配置。
介绍
这个Skill解决了Pi平台用户需要同时管理通用和个性化代理配置文件的痛点。在Pi中，AGENTS.md文件通常用于定义团队或项目共享的代理配置，但用户个人的、实验性的或环境特定的配置需求难以融入其中。
它的使用方式非常简单直接。安装此Skill后，Pi在加载标准的AGENTS.md上下文文件时，会自动并行加载一个名为AGENTS.local.md的文件。用户只需在与AGENTS.md相同的目录下创建并编辑AGENTS.local.md，即可在其中添加自己的私有代理定义、覆盖默认设置或进行临时测试，而无需修改共享的AGENTS.md文件。
它非常适合需要在Pi平台上进行个性化AI工作流定制的开发者、团队中希望在不影响公共配置的前提下进行个人实验的成员，以及任何希望将环境变量、私有API密钥等敏感信息与通用配置分离的用户。
使用建议是，将AGENTS.local.md文件添加到.gitignore中，以确保个人配置不会意外提交到版本库。同时，可以利用此功能来隔离开发、测试和生产环境的配置差异，或者为不同的任务场景快速切换代理组合。
核心特点
核心区别在于它无缝扩展了Pi的原生代理加载机制，而非创建一个全新的配置系统。它直接与官方的AGENTS.md文件协同工作，实现了配置的“分层”与“继承”，让个人配置与团队配置自然共存，无需改变用户已有的使用习惯。
注意事项
此Skill仅适用于使用Pi平台并依赖AGENTS.md文件管理代理上下文的场景，对于其他AI IDE或使用不同配置方式的工具无效。
常见问题
AGENTS.local.md和AGENTS.md有什么区别？
AGENTS.md是共享的通用配置，AGENTS.local.md是用户个人的、本地的配置，后者内容会与前者一同加载，常用于覆盖或添加个人设置。
如何创建AGENTS.local.md文件？
只需在与AGENTS.md文件相同的目录下，新建一个文本文件并命名为AGENTS.local.md，然后按照AGENTS.md的格式编写你的个人代理配置即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/foxfirecodes-pi-agents-local-md/raw/index.md 读取 @foxfirecodes/pi-agents-local-md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/foxfirecodes-pi-agents-local-md/raw/index.md（查看排版版本）