@realvendex/pi-lint
专为Pi原生扩展设计的静态代码检查工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@realvendex/pi-lint。 它的用途是：专为Pi原生扩展设计的静态代码检查工具 完整的 Skill 内容见：https://321skill.com/skills/realvendex-pi-lint/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查当前目录下 Pi 扩展项目的代码规范问题。”，AI 会调用 pi-lint 对项目进行扫描，并列出所有检测到的 Pi API 使用不当、潜在运行时错误或反模式，给出具体的文件和行号定位。
介绍
Pi-lint 是一款专为 Pi-native 扩展开发设计的静态代码检查工具。它主要解决开发者在编写 Pi 平台原生扩展时，因不熟悉或误用 Pi 特定 API 而引入的潜在运行时错误和反模式问题，帮助开发者在代码发布前及早发现并修复这些问题。
使用方式非常简单，开发者只需在项目中安装此 npm 包，并将其集成到开发流程或 CI/CD 流水线中。它可以在代码编写、提交或构建阶段运行，自动扫描项目代码，识别出不符合 Pi 平台最佳实践或可能导致运行时错误的 API 使用方式，并给出具体的错误或警告信息。
这款工具非常适合为 Pi 平台开发原生扩展的开发者，尤其是那些希望提升代码质量、确保扩展稳定性和遵循平台规范的团队或个人。它能有效减少因低级 API 误用导致的线上故障。
建议在项目初期就引入此工具，并将其作为代码提交前的强制检查环节。需要注意的是，它主要聚焦于 Pi 特定 API 的静态模式匹配，对于业务逻辑错误或动态行为无法检测，因此仍需结合其他测试手段以确保代码质量。
核心特点
与通用 JavaScript/TypeScript 代码检查工具（如 ESLint）不同，它深度集成了 Pi 平台的特定 API 规则，能精准识别 Pi 生态下的反模式；同时，其检查过程完全确定且不依赖外部 LLM 调用，保证了检查结果的稳定性和速度。
注意事项
不适用于检查非 Pi 平台的项目代码或复杂的业务逻辑错误。
常见问题
pi-lint 和 ESLint 有什么区别？
pi-lint 专门检查 Pi 平台 API 的误用和反模式，而 ESLint 是通用的 JavaScript/TS 语法和风格检查工具。
使用 pi-lint 需要联网吗？
不需要，其检查规则是确定性的，无需调用外部 LLM 服务。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/realvendex-pi-lint/raw/index.md 读取 @realvendex/pi-lint 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/realvendex-pi-lint/raw/index.md（查看排版版本）