用途：这是 pi-extensions 环境的使用说明，面向在该 monorepo（32 个包，用于扩展 pi 编码代理）中工作的代理，讲清如何用环境提供的工具完成任务。
主要能力与用法：
- 代码模式：核心工具是 execute_code，所有文件读写、bash、编辑、grep 都在代码块中完成，可用循环、分支与 await 组合多步操作。
- 工作记忆：写在 $ 上的变量可跨代码块保留，普通 const 不行；$ 在报错后仍存活，可用 $.__pin('name') 防止被内存淘汰。
- 历史检索 ouija：可按 BM25 检索以往会话（含已结束会话）与当前会话，支持 search/self/view/list，并可对任意对象数组做检索。
- 记忆记录 mai：用 mai.note(ticketId, "...") 记录持久决策，之后用 ouija 找回原始过程。
- 委派 teams：teams.delegate 可并行为多个代理（各有独立 git worktree 与 pi 会话）派发任务；建议用 template 而非直接指定 model。等待用 teams.on(...)，短时用轮内 await 或 Promise.race，长时用 supervise(false) 加 console.wake 的后台唤醒；订阅需加 .timeout(ms)，自己处理事件时链 .preventDefault()。
- 其他：tldr 做结构分析（语义搜索、结构、调用影响、死代码），fff 做文件查找与内容搜索；Bash 适合 30 秒内的短命令，较长命令用 bashBgStart 配 .timeout 或 .each/.then，长期不退出的进程不加 await；整块耗时可传 async: true 返回 jobId，结果作为后续轮次送达。
限制与注意：同步 execute_code 超 60 秒会自动转为异步；并发 execute_code 按会话互斥串行；git 破坏性命令（如 push --force、reset --hard）在代码模式被阻止，需用户手动执行；模式 B 必须 supervise(false)，否则空闲时会被巡检消息刷屏。