docs: 拆分 AGENTS.md,根文件只保留全局规则

根 AGENTS.md 从约 78KB 压缩到约 10KB,避免作为常驻规则加载时被截断:
只保留仓库定位、扩展清单、跨扩展硬规则与通用验证命令。各扩展的维护
约定与验证命令移入对应目录的 AGENTS.md(新增 extensions/AGENTS.md 承载
系统提示词与根目录 TS/LSP 约定),上游来源记录统一放进各目录的中文
UPSTREAM.md,并补齐 pi-permission-system 与 pi-rtk-optimizer 的来源记录。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
云服务部-叶林立
2026-10-20 19:43:22 -07:00
co-authored by Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
parent 360d8cffc8
commit 0c45b1a438
17 changed files with 302 additions and 308 deletions
+1 -1
View File
@@ -13,4 +13,4 @@
初始导入保留了上游 TypeScript 源码、测试、示例、文档、媒体、包元数据和许可证。上游 `.github/` 自动化与本地 `.pi/` 状态有意未导入。
源码包含在根包中,并通过根 `file:./pi-subagents` 依赖安装,而宿主自有的 `extensions/subagents.ts` wrapper 当前不由根 `pi.extensions` 默认加载。本地快照新增了文档化的权限子会话生命周期桥接、根 authority 转发身份、活跃 Agent 身份,以及宿主自有的精确路径 mandatory extension 策略。组合包 wrapper 保护 `extensions/permission-system.ts` 免受 Agent 控制的扩展过滤,并在该入口不可用时 fail closed。根编排工具归入 Tool Search 已提交的 `subagents` 分组,Pi host peer 标记为 optional,以免组合包安装第二套 Pi runtime。
源码包含在根包中,通过根 `file:./pi-subagents` 依赖安装,并由宿主自有的 `extensions/subagents.ts` wrapper 经根 `pi.extensions` 默认加载。本地快照新增了文档化的权限子会话生命周期桥接、根 authority 转发身份、活跃 Agent 身份,以及宿主自有的精确路径 mandatory extension 策略。组合包 wrapper 保护 `extensions/permission-system.ts` 免受 Agent 控制的扩展过滤,并在该入口不可用时 fail closed。另新增三个 opt-in 扩展选项(`basePrompt`、`bundledAgentsDir`、`excludedExtensionPaths`,经 `createPiSubagentsExtension` → `AgentManager` → agent-runner → `buildAgentPrompt` 透传),不传时保持上游逐字节行为。根编排工具归入 Tool Search 已提交的 `subagents` 分组,Pi host peer 标记为 optional,以免组合包安装第二套 Pi runtime。