pi-read-before-write
防止AI在文件被外部修改后执行过时的写入操作
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-read-before-write。 它的用途是：防止AI在文件被外部修改后执行过时的写入操作 完整的 Skill 内容见：https://321skill.com/skills/pi-read-before-write/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我修改src/utils.js文件里的calculate函数。”，如果该文件在你上次读取后被队友更新了，Skill会阻止AI直接写入，并提示你：“检测到文件已更改，建议我先读取最新内容再修改。”
介绍
这个Skill主要解决AI助手在协作或长时间任务中，因文件被外部修改（如其他开发者提交、手动编辑）而执行过时写入操作的问题。它通过在AI执行编辑或写入操作前，自动检查文件自上次读取后是否被更改，从而阻止潜在的冲突和数据覆盖。
使用时，该Skill作为Pi编辑器的一个扩展，会在后台自动运行。当AI尝试写入一个文件时，它会比对文件的当前状态与AI上次读取时的状态。如果发现不一致，则会阻止写入并提示用户文件已更改，需要重新确认或读取最新内容。
它非常适合在多人协作的代码库、频繁更新的文档项目或任何需要AI长时间处理文件的环境中工作的开发者、技术写作者和项目管理者。它能确保AI的操作始终基于最新的文件上下文。
建议在启用此Skill后，养成在关键写入前让AI主动确认文件状态的对话习惯。注意，它主要依赖AI自身对文件的“读取”记录，如果AI从未读取过某个文件，则无法检测外部更改。在高度动态或版本控制操作（如git合并）频繁的场景中，仍需人工复核。
核心特点
与仅提供文件锁或简单版本提示的Skill不同，它深度集成到AI的读写流程中，在操作执行前进行主动拦截，而非事后告警，从根本上避免了数据覆盖风险。
注意事项
不适合处理AI从未读取过的文件，或文件更改发生在AI同一会话内且未被外部工具记录的场景。
常见问题
这个Skill能防止git合并冲突吗？
不能完全防止，但能减少AI因使用旧版本文件而无意中覆盖新合并内容的风险。
它会影响AI的响应速度吗？
仅在执行写入操作前进行快速校验，对常规对话和读取操作几乎没有性能影响。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-read-before-write/raw/index.md 读取 pi-read-before-write 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-read-before-write/raw/index.md（查看排版版本）