llp

面向：有一定开发基础、刚接触 Pi Agent 的读者
依据：文末「已安装扩展清单」；包名、版本、skill / agent / prompt / team 与清单逐字一致
写法：高频核心详写，其余简表；skill 按类归纳，每类 2～3 个代表，完整名单见附录

1. 读前地图：扩展怎么分工

四层能力：

1. 触角：联网、浏览器、MCP
2. 编排：子代理、Crew、后台任务
3. 方法论：bigpowers / goal / simplify
4. 会话体验：问卷、待办、旁路提问、上下文压缩、长期记忆

flowchart TB
  subgraph Sense["触角"]
    MCP["pi-mcp-adapter 2.34.0"]
    WEB["pi-web-access 0.29.0"]
    CHR["pi-chrome 0.15.51"]
  end

  subgraph Orchestrate["编排"]
    SUB["pi-subagents 0.68.0"]
    CREW["pi-crew 0.11.1"]
    BG["pi-background-tasks 2.5.0"]
  end

  subgraph Method["方法论"]
    BP["bigpowers 2.88.7"]
    GOAL["pi-goal-x 0.31.6"]
    SIM["pi-simplify 0.2.3"]
  end

  subgraph Session["会话体验"]
    ASK["@juicesharp/rpiv-ask-user-question 2.10.1"]
    TODO["@juicesharp/rpiv-todo 2.10.1"]
    BTW["@narumitw/pi-btw 0.60.0"]
    CTX["billion-context 0.1.119"]
    MEM["pi-memory 0.4.2"]
  end

  User["你 / 主会话"] --> Orchestrate
  Orchestrate --> Sense
  Orchestrate --> Method
  User --> Session
  Method -.->|"skill 约束何时委派/验证"| Orchestrate
  Sense -.->|"工具结果回灌"| User

2. 核心扩展详解

2.1 pi-mcp-adapter 2.34.0

核心功能
接 MCP 服务器，给 Pi 增加 MCP 工具。

具体能力

• 连接并使用 MCP Server 暴露的工具
• skill：mcp-scripting — 用 JS 批量发现/调用 MCP 工具

典型场景

• 规范要求通过 MCP 访问外部系统或文档
• 需要脚本化批量探查/调用多个 MCP 工具

示例

1. 配置 MCP 后，在对话中让 Pi 列出工具并调用指定工具。
2. 批量场景启用 mcp-scripting，用 JS 发现并调用。

附带 skill

2.2 pi-subagents 0.68.0

核心功能
子代理委派与脚本化工作流。

具体能力

• 委派、并行、workflowScript
• skill：pi-subagents、council-mode（/council）
• prompts：council、gather-context-and-clarify、parallel-cleanup、parallel-research、parallel-review、review-loop
• 内置 agent：scout、worker、oracle、reviewer、researcher、delegate、evidence-auditor，以及 Claude Code / Codex / Cursor 桥接

典型场景

• 大改前探路：scout / researcher
• 实现与审查分离：worker + reviewer
• 多视角决策：/council（council-mode）

示例

1. 「用 pi-subagents 并行：一侧梳理调用链，一侧起草方案，汇总后再改。」
2. 「走 council-mode，对本设计做顾问会审。」

2.3 pi-crew 0.11.1

核心功能
多代理团队、worktree、异步编排。

具体能力

• 内置 team：default、fast-fix、implementation、research、parallel-research、review
• 内置 agent：orchestrator、planner、executor、explorer、reviewer、verifier、oracle、analyst 等
• 34 个 skill（全表见附录 A）
• 若仓库早有 .pi/，可能出现 legacy 布局下的 .pi/teams/ 运行痕迹

典型场景

• 功能开发：team implementation
• 热修：fast-fix
• 调研：research / parallel-research
• 并行改动隔离：worktree-isolation / workspace-isolation

示例

1. 「用 implementation 团队：planner 出任务包 → executor 在 worktree 实现 → verifier 关门。」
2. 「只读探代码」→ read-only-explorer / explorer。

代表性 skill（每类 2～3 个）

其余名称见附录 A，不逐条展开。

2.4 bigpowers 2.88.7

核心功能
工程方法论 skill 包（约 80 个）；入口 using-bigpowers，按生命周期分阶段。

具体能力

• 覆盖发现→设计→计划→执行→验证→排障→Git/发布→基建→文档/skill
• search-skills、stocktake-skills 检索与盘点
• 用具体 skill 落实「先研究、先定义成功、完成前验证」等纪律

典型场景

• 新功能：research-first → elaborate-spec → plan-work / slice-tasks → develop-tdd → verify-work
• 重构：plan-refactor → 执行 → validate-fix / audit-code
• 发布：plan-release → release-branch → request-review → deploy

示例

1. 「先 using-bigpowers，再 research-first + elaborate-spec，然后 plan-work。」
2. 「实现用 develop-tdd，结束前必须 verify-work。」

bigpowers 生命周期总览

flowchart LR
  A["引导\nusing-bigpowers\nsearch-skills\nstocktake-skills"] --> B["发现\nsurvey-context\nresearch-first\nelaborate-spec\nmap-codebase"]
  B --> C["设计\nmodel-domain\ndefine-success\ngrill-*\ndesign-interface"]
  C --> D["计划\nscope-work\nslice-tasks\nplan-*"]
  D --> E["执行\ndevelop-tdd\ndelegate-task\nexecute-plan"]
  E --> F["验证\nverify-work\nvalidate-*\naudit-*\nsecurity-review"]
  F --> G["排障\ninvestigate-bug\ndiagnose-*\nassess-impact"]
  G --> H["Git/发布\nguard-git\nrequest-review\ndeploy"]
  H --> I["基建/文档\nwire-ci\ncraft-skill\nmaintain-wiki"]

各阶段代表 skill

全表见附录 B。

3. 其余扩展（简表）

不附带 skill，只注册 extension：

4. 推荐组合拳

1. 小改动：必要时 rpiv-ask-user-question → 直接改 → pi-simplify
2. 中型功能：bigpowers 主干（research-first → elaborate-spec → plan-work → develop-tdd → verify-work）；并行调研加 pi-subagents
3. 多角色/隔离：pi-crew team + worktree-isolation；关门用 verification-before-done
4. 外部系统：pi-mcp-adapter（+ mcp-scripting）；登录态网页 pi-chrome；公开网页 pi-web-access
5. 长会话：billion-context + 重要结论进 pi-memory；旁路用 /btw

5. 边界说明

• 名称与版本均来自安装清单，不虚构清单外功能。
• 升级后以你本机 settings.json / npm/package.json 为准。
• 若 stocktake-skills 与附录不一致，以本机盘点为准。

附录 A. pi-crew 34 skill

async-worker-recovery、child-pi-spawning、context-artifact-hygiene、council、delegation-patterns、distill-persona、distill-software、event-log-tracing、git-master、iterative-audit、live-agent-lifecycle、mailbox-interactive、model-routing-context、multi-perspective-review、observability-reliability、orchestration、ownership-session-security、pi-extension-lifecycle、post-mortem、read-only-explorer、real-test-pi-crew、requirements-to-task-packet、research、resource-discovery-config、runtime-state-reader、safe-bash、scrutinize、secure-agent-orchestration-review、state-mutation-locking、systematic-debugging、verification-before-done、widget-rendering、workspace-isolation、worktree-isolation

team： default、fast-fix、implementation、research、parallel-research、review

agent（清单所述）： orchestrator、planner、executor、explorer、reviewer、verifier、oracle、analyst 等

附录 B. bigpowers 阶段全表

附录 C. npm 包与版本