---
title: 'PI v3 Cross Agent PI'
video_id: f8cfH5XX-XU
url: https://youtu.be/f8cfH5XX-XU
title_en: "The Pi Coding Agent: The ONLY REAL Claude Code COMPETITOR"
channel: IndyDevDan
published: 2026-02-23
duration: "51:36"
topics: [MCP 与工具调用]
noted: 2026-07-07
value: S
part: 5
views: '22.8万'
---


↑ [返回课程总览](00-总览.md) · [上一章](04-v2-Minimal.md) · [下一章](06-v4-Purpose-Gate.md)

> IndyDevDan · 51:36 · 发布 2026-02-23 · 22.8万次观看(截至抓取) · [观看原视频](https://youtu.be/f8cfH5XX-XU)
> 🔥 观众最高回放 [29:56](https://youtu.be/f8cfH5XX-XU?t=1796) — 本片高回放时刻见对应章节

## 主旨

让 Pi **从多个 location 同时加载** commands / skills / agents——全局(global) + 项目级(local)双源,**让"哪些组件从哪里读"成为声明层配置**,而不是某个固定路径。

## 核心论点

1. **Pi 的组件加载是声明式的 location 列表**——你的 ext / skill / command / agent 可以来自任何 path,你不绑单一固定目录。([[#1-声明式-location-列表-1110|→ 详解1]])
2. **同时支持全局(global)+ 项目级(local)双 scope**,与 Claude Code 共用 `.claude/` 路径的设计相比,**Pi 不替你决定** "组件在哪"。([[#2-全局-vs-项目级双-scope-1110|→ 详解2]])
3. **多个 location 一次性全 load,显示来源与数量**:比如"41 skills 已 load" + 项目级 commands + 5 个 agents——所有组件一目了然。([[#3-全量加载展示-1110|→ 详解3]])
4. **v3 的真正差异化是把"工具集合的来源"提到用户面**——你不再受制于单一目录,你可以按项目/团队/角色同时混用多源 ext。([[#4-与-v1--v2-相比的差异化-1110|→ 详解4]])

## 知识点详解

### 1. 声明式 location 列表 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)

作者用 ext 显示 Pi 已经**从多个 location** 加载了 commands / skills / agents。屏幕上,Pi 会列出每类组件的来源路径。开发者不再需要在固定目录里编辑——ext 可以从自己公司 / 团队共享的 git 仓库、用户本机配置、项目级脚本等多个地方拉。

这一设计与 v6 widget 的 hookable 共属一套:**Pi 不做隐式的"固定 home",所有 path 都 explicit**。

### 2. 全局 vs 项目级双 scope [11:10](https://youtu.be/f8cfH5XX-XU?t=670)

演示中 Pi 列出了**41 个全局 skills**(来自 `~/.pi/skills/` 或类似),**项目级 slash commands**(来自 `~/.../classic/prime`)与**项目级 agents**(来自 `~/.../agents/`)。两类组件并行加载,互不冲突。

> And you can see here it's picked these up in multiple locations. ([11:10](https://youtu.be/f8cfH5XX-XU?t=670))

这与 Claude Code 的"`~/.claude` 单源"形成对照——Claude Code 也支持项目级 `.claude/`,但**优先级 / 命名冲突的处理常常是默默进行的**;Pi 让来源**显式可见**。

### 3. 全量加载展示 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)

> You can see here it's picking up all of my custom global skills, 41 skills, but also in this directory, you can see we have a classic/prime command. And you can see I've picked up a bunch of agents as well. ([11:10](https://youtu.be/f8cfH5XX-XU?t=670))

这是 v3 给工程师的最直接价值:**全量能力面板**,你不用去翻每个目录找有什么,Pi 直接告诉你有哪些组件被加载。这是"自动 inventory"——你不需要同步文档。

### 4. 与 v1 / v2 相比的差异化 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)

v1 / v2 改的是**界面与交互**;v3 改的是**组件来源**。这也是后续章节的基础——v6 widget、v7 subagent、v9 agent team 都依赖"组件可以来自任何 location"这一基础保障。

## 可执行步骤

- [ ] 在自己的 Pi 配置里加一个非默认 location(比如 `~/.pi/team-extensions/`),把自己团队的 ext 复制进去
- [ ] 在 ext 配置文件里声明该 location,启动 Pi 看是否所有组件都被加载
- [ ] 验证两个 location 有同名 skill 时的优先级行为(后到的覆盖前到的?文件顺序?)
- [ ] 在团队 member 的 ~/.pi/skills/ 上线一个新 skill,项目里跑 Pi 看是否自动出现

## 关联

- 互补(同能力层但是另一边的实施):本片 [09-v7-Subagent-Widget.md](09-v7-Subagent-Widget.md) — subagent 也是从声明式 location 加载,与 v3 一致
- 印证(全量能力面板可以减少文件同步成本):[[2026-04-01-用LightRAG给Claude Code接上Graph RAG知识库|Graph RAG 笔记]] —— 给 agent 一张知识图谱等于给 agent 全量能力面板,本片 v3 是同一原则在 ext 上的实现
- 互补(同一原则):[[UPtmKh1vMN8-Claude Code 高阶课/19-搭建 Auto-Research|CC 高阶课·搭建 Auto-Research]] —— CC 也强调 ext 加载位置可配置,但 Pi 把这一切显式化

## 一手来源与延伸

- Pi extension 文档:[https://pi.dev/](https://pi.dev/) — location 声明语法
- 视频 11:10-11:53(v3 cross-agent 演示)

## 术语

- **Location**:Pi 找组件(skills/commands/agents)的具体路径,可声明多个
- **Global scope**:与项目无关、跨项目复用的组件位置
- **Project / local scope**:仅在当前项目目录生效的组件位置

## 金句

> You can see here it's picked these up in multiple locations. ([11:10](https://youtu.be/f8cfH5XX-XU?t=670)) — Pi 不绑单一来源。

## 立场与利益

- 利益中性:location 加载是工具性能力,无直接挂商品

## 价值定位

对**本片目标学习者**的价值:

- 适合谁:有团队 / 多项目并行工作的工程师,**需要共享 ext 与项目 ext 不互干扰**
- 解决什么:在 Pi 配置里声明**全局 + 项目**多个 location,避免每个项目都得重复安装
- 认知 vs 实操:偏实操——5 分钟配置即可上手
- 跨源重叠少:这是 Pi 特有视角,v3 把"加载面"作为配置对象,与 Claude Code 的单源设计形成对照

## 自检问题

1. v3 演示的 location 多源加载具体加载了哪几类组件?
   **答案**:三类——commands / skills / agents,各自来自全局 (41 skills) + 项目 (classic/prime + agents) 多个 location。回跳 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)
2. Pi 的 location 多源加载与 Claude Code 的固定路径有什么本质差异?
   **答案**:Pi 让来源显式可见,你可以从任何 path 拉;Claude Code 默认 `~/.claude/` + 项目 `.claude/` 双源,冲突处理常常默默进行。Pi 的设计是"你掌握 inventory"。回跳 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)
3. 全量能力面板在团队协作上的最大价值是什么?
   **答案**:你不需要同步文档,Pi 启动时告诉你有哪些组件被加载,降低"组件更新但没人知道"的失同步风险。回跳 [11:10](https://youtu.be/f8cfH5XX-XU?t=670)