@realvendex/pi-compat
Pi.dev 扩展的版本兼容性检查工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@realvendex/pi-compat。 它的用途是：Pi.dev 扩展的版本兼容性检查工具 完整的 Skill 内容见：https://321skill.com/skills/realvendex-pi-compat/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查当前 Pi 扩展项目对 Pi-native v2 的兼容性。” 它会引导你在项目目录下执行兼容性检查命令，并解析生成的报告，指出使用了哪些已废弃的 API，以及如何修改代码以适配目标版本。
介绍
该 Skill 旨在解决 Pi.dev 平台扩展开发者在不同 Pi-native 版本间遇到的兼容性问题。随着 Pi 平台 API 的迭代更新，扩展可能因使用了已废弃或移除的 API 而无法正常工作。此工具通过静态分析，帮助开发者提前发现潜在风险。
使用方式非常直接。开发者只需在扩展项目的根目录下运行该工具，它便会自动扫描代码，识别出所有对 Pi API 的调用。随后，工具会将这些调用与已知的版本约束进行比对，并生成一份详细的报告。
它非常适合为 Pi.dev 平台开发扩展的独立开发者或团队，尤其是那些需要维护多个扩展或确保扩展能长期兼容不同 Pi 版本的项目。在发布新扩展或升级现有扩展以适配新 Pi 版本时，使用此工具能有效避免运行时错误。
建议在每次准备发布扩展版本前，或计划将扩展迁移到新的 Pi-native 版本时，都运行此检查器。请注意，它主要进行静态代码分析，对于动态加载或通过字符串拼接生成的 API 调用可能无法完全覆盖，因此仍需结合手动测试以确保万无一失。
核心特点
与通用的代码质量检查工具不同，它专为 Pi.dev 扩展生态设计，内置了 Pi API 的版本变更知识库，能精准识别已废弃或移除的 API 并提供具体的迁移建议，而非仅仅报告代码风格问题。
注意事项
不适合用于检查非 Pi.dev 扩展项目或动态生成的、非静态可分析的 API 调用场景。
常见问题
pi-compat 怎么用？
在扩展项目根目录运行 npx @realvendex/pi-compat 即可扫描并生成兼容性报告。
pi-compat 能检查哪些问题？
能检查扩展使用的 Pi API 是否在当前或目标版本中可用、是否已被废弃，并给出迁移路径。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/realvendex-pi-compat/raw/index.md 读取 @realvendex/pi-compat 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/realvendex-pi-compat/raw/index.md（查看排版版本）