pi-windows-path-guard

介绍

该Skill旨在解决一个在Windows系统上使用Git Bash或MSYS等类Unix环境时，与原生Windows Pi文件工具交互时可能出现的隐蔽问题。当AI Agent或开发者复用类似“/c/Users/…”这样的类Unix路径格式时，Windows原生的Pi工具可能会错误地解析这些路径，导致文件被静默写入到意想不到的、甚至被“篡改”的目录中，从而引发数据丢失或混乱。

使用方式非常简单直接。它是一个npm包，用户只需在项目中安装并引入该守卫模块。之后，当代码中涉及到通过Pi工具进行文件操作时，该守卫会自动检测并拦截那些可能导致路径混淆的调用，从而防止错误的写入操作发生。

这个Skill非常适合在Windows平台上，混合使用Git Bash/MSYS终端与Node.js脚本或AI Agent进行文件操作的开发者。特别是那些需要编写跨平台兼容脚本，或者使用AI工具（如Claude、Cursor）生成文件操作代码，而生成代码中可能包含类Unix路径格式的场景。

建议在项目初期或引入新的文件操作逻辑时就集成此Skill，作为一道安全防线。需要注意的是，它主要防护的是Pi工具（一个特定的Windows原生文件工具库）的路径混淆问题，并非一个通用的路径转换工具。对于其他文件系统库或纯粹的跨平台路径处理，可能需要结合其他方案。