用途：在修改 Pi 扩展代码或排查 Pi 启动警告前使用，帮助安全地构建、调试和维护 Pi 扩展。
主要能力：说明扩展的规范位置，包括仓库内 joelclaw 扩展 ~/Code/joelhooks/joelclaw/pi/extensions/<name>、活动符号链接 ~/.pi/agent/extensions/<name>、包扩展 ~/.pi/agent/git/github.com/<owner>/<repo> 及包配置 ~/.pi/agent/settings.json；给出会话安全规则，如 ctx.newSession()、ctx.fork()、ctx.switchSession()、ctx.reload() 会使旧 pi 和 ctx 对象失效，替换命令应使用 withSession 回调，reload 后应视为终止；要求使用 pi.registerTool() 而非已移除的 pi.addTool()，工具结果需可克隆，可选依赖必须懒加载，避免顶层导入，缺失时禁用功能而非导致启动崩溃；强调每个扩展只保留一个活动副本，避免重复钩子与消息。
使用方式：先运行低成本检查，如 bun --check path/to/extension/index.ts、PI_OFFLINE=1 pi --help 并检索错误输出；包更新使用 pi update，npm 全局安装 @earendil-works/pi-coding-agent@latest 等；用 pi -p 命令对基础 Pi 与完整扩展启动做冒烟测试；若存在多个 pi 二进制，需确认版本一致。
适用场景：编辑 ~/.pi/agent/extensions、joelclaw/pi/extensions、pi-tools 扩展，或调试 Pi 启动警告与扩展冲突。
限制：资料未提供该技能的收费、价格、平台支持范围与效果数据；具体实现细节以官方文档为准。