@amartinr/pi-ts-prelint

介绍

这个Skill解决了在AI编码代理（如Pi）中修改TypeScript文件后，无法及时发现编译错误的问题。实际开发中，AI代理频繁写入.ts/.tsx文件，但编译错误往往在后续步骤才暴露，导致上下文混乱和token浪费。该工具通过拦截write/edit操作，在文件修改后立即运行tsc —noEmit，并将错误信息结构化注入工具结果，让模型在下一轮自动修复。

使用方式很简单，你只需要在项目中安装该扩展（通过npm或Pi扩展市场），并确保项目已配置TypeScript。之后当AI代理编辑.ts/.tsx文件时，工具会自动触发：先计算修改复杂度，若超过阈值（默认15行或10%），则执行tsc检查；即使编译失败，文件修改仍会生效，但错误会作为上下文返回给模型。你还可以通过项目级或全局配置文件调整触发阈值和错误展示规则。

它非常适合需要频繁使用AI编码代理开发TypeScript项目的团队或个人。尤其是那些已经使用Pi、Claude等AI助手进行代码生成，并希望在不阻塞工作流的前提下提高代码质量的场景。前端开发、全栈开发和智能体开发者都能从中受益，因为编译错误越早发现，修复成本越低。

建议在项目初始化时统一配置该工具，并合理设置changeComplexity阈值，避免对过于微小的改动也执行检查（浪费token）。需要注意的是，它仅检查单个文件，不会发现跨文件依赖错误，且是完全非阻塞的——模型必须主动注意到错误并修复。对于大型项目，可考虑结合全局tsc检查作为补充。