用途：让 pi 扩展适配其导入的 pi 包（@earendil-works/... 说明符）的最新发布版本，或通过 target=<version> 指定版本。分两层：兼容层（步骤3–4）在零行为变更前提下修复破坏性变更，仅当行为变更不可避免时才需用户确认；采纳层（步骤6）调研自安装版本以来新增的 API/功能，逐项列出收益、范围与风险，仅采纳用户选中的项，且一次一项。
主要步骤：1）解析目标版本、定位包并阅读变更日志，用 npm view <pkg> dist-tags.latest 获取最新版并交叉核对 GitHub releases，不得从旧报告、GLOSSARY.md、ADR、git 历史或已安装 devDependencies 推断目标；2）核对真实导入面，枚举所有 from "@earendil-works/..." 说明符（顶层、子路径如 @earendil-works/pi-ai/compat、深层导入如 @earendil-works/pi-tui/dist/word-navigation.js），验证其在目标版本中可解析；3）对每个破坏性变更分类为仅类型修复或契约变更，仅在扩展镜像 pi 内部实现时做镜像漂移检查；4）以最小改动修复，遵循仓库 AGENTS.md；5）运行仓库测试命令并更新受契约影响的测试；6）调研新能力并按用户选择逐项实现、单独验证；7）按仓库约定写文档并报告解析出的目标版本，未验证项标注 [NEEDS MANUAL VERIFICATION]。
限制：目标变更日志、目标类型、导出映射与官方文档为权威来源；版本号、路径、行号、API 名称仅为快照提示。未映射子路径会解析到仓库自身固定版本，产生看似 SDK 漂移的“双版本类型同一性”错误。默认不构建、不发布；发布遵循仓库发布约定，可衔接 npm-release 技能。资料未提供具体包版本、平台与收费信息。