AGENTS.md 与资源加载

沿执行轨迹走

1. 上下文文件分层

   Pi 会读取全局 ~/.pi/agent/AGENTS.md，再沿项目目录加载 AGENTS.md 或 CLAUDE.md；同目录存在 AGENTS.override.md 时，它替代该目录的普通上下文文件。

   [repo] [docs]

2. 系统提示与资源不是一回事

   系统提示可由 SYSTEM.md 替换或由 APPEND_SYSTEM.md 追加；Extension、Skills、prompts、themes 和 package 资源则由 ResourceLoader 单独发现，SDK 也可传入自定义加载器。

   [repo]

3. 项目信任的边界

   首次遇到项目本地设置、资源或扩展时，交互模式可要求信任确认；拒绝后跳过受保护资源，但上下文文件仍会按规则加载，除非显式关闭。

   [repo] [docs]

每一步改变了什么

• 排查“为什么这次行为不同”时，应同时列出上下文文件、系统提示、项目设置、启用的 Package 与 Extension。

• 对不可信仓库，拒绝项目资源并不消除文档或源码中的提示注入风险；仍需限制工具和运行环境。

这条轨迹没有说明什么

• 资源发现路径和信任策略可被设置或 CLI 参数覆盖，不能只凭目录中有无 .pi 判断最终加载结果。