@harms-haus/pi-lens

为pi自动运行代码质量检查的扩展

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@harms-haus/pi-lens。
它的用途是:为pi自动运行代码质量检查的扩展
完整的 Skill 内容见:https://321skill.com/skills/harms-haus-pi-lens/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我用pi-lens检查一下刚才修改的src/utils.ts文件。”,它会自动触发对该文件的Prettier格式化、ESLint规则检查、LSP诊断以及TypeScript类型检查,并将所有结果汇总反馈给你,指出需要修复的问题。

介绍

pi-lens 是一个专为 pi 设计的统一代码质量扩展。它主要解决了开发者在提交代码前,需要手动或分别运行多种代码质量工具(如格式化、静态检查、类型检查)的繁琐问题,确保代码变更符合规范,避免低级错误进入代码库。

使用方式非常简单。在安装了 pi-lens 后,当你使用 pi 进行开发并修改了文件,该扩展会自动在后台对变更的文件依次运行 Prettier 代码格式化、配置的 Linter(如 ESLint)、语言服务器协议(LSP)诊断以及 TypeScript 编译器(tsc)检查。整个过程无需手动触发,实现了代码质量保障的自动化。

它非常适合所有使用 pi 进行项目开发的工程师,特别是那些遵循严格代码规范、使用 TypeScript 或需要集成多种代码检查工具的团队。对于追求开发流程自动化、希望将代码质量门禁左移(Shift-Left)到编码阶段的开发者来说,这是一个得力助手。

建议在项目初期或配置好统一的代码规范后集成此 Skill,以获得最佳体验。需要注意的是,它依赖于 pi 环境以及项目内已正确配置的对应工具(如 .prettierrc, .eslintrc 等)。初次使用时可先在小范围文件上测试,确保所有检查工具的配置符合预期,避免因规则冲突导致流程中断。

核心特点

核心区别在于其“统一”与“自动化”:它并非单个工具,而是将 Prettier、Linter、LSP 诊断和 tsc 这四类常见的代码质量检查流程无缝集成并自动针对变更文件运行,省去了分别配置和手动执行的麻烦,在 pi 生态内提供了开箱即用的端到端质量守护。

注意事项

不适合项目尚未配置任何底层代码质量工具(如 ESLint、Prettier)或主要使用 pi 进行非代码类文本编辑的场景。

常见问题

pi-lens 支持哪些代码检查工具?

默认自动集成并运行 Prettier、Linter(如ESLint)、LSP诊断和TypeScript编译器(tsc)。

它会影响 pi 的编辑性能吗?

它仅在文件变更后触发检查,针对性强,通常影响很小,但检查工具本身若非常耗时可能会带来短暂延迟。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/harms-haus-pi-lens/raw/index.md 读取 @harms-haus/pi-lens 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。