pi-hash-anchored-edit
为Pi代码助手提供基于哈希锚点的读写编辑工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-hash-anchored-edit。 它的用途是：为Pi代码助手提供基于哈希锚点的读写编辑工具。 完整的 Skill 内容见：https://321skill.com/skills/pi-hash-anchored-edit/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用pi-hash-anchored-edit，在文件`utils.js`中查找锚点`#feature:auth`对应的代码块并替换为新版本。”，它会先通过锚点定位到目标代码，然后安全地执行替换操作，并确保锚点标识的准确性。
介绍
该Skill旨在解决AI代码助手在处理大型或复杂文件时，难以精准定位和修改特定代码片段的问题。它通过引入“哈希锚点”的概念，为代码块生成唯一标识，从而实现对代码的精确读取和替换，避免了传统行号定位在文件变动后容易失效的缺陷。
使用时，开发者或AI助手可以在代码中插入特定的哈希锚点注释（例如 // #hash:abc123），之后便可通过引用此锚点来可靠地读取或覆写对应的代码区域。这尤其适用于需要多次迭代修改或协作的场景。
它非常适合经常使用AI（如Pi、Claude等）进行代码生成、重构或审查的开发者，特别是在处理项目模板、重复性代码模式或需要持续维护的代码库时，能显著提升编辑的准确性和效率。
建议在使用前为关键或可能频繁变动的代码段预先添加锚点。请注意，锚点注释本身是代码的一部分，需保持其唯一性且避免手动修改，否则可能导致定位失败。
核心特点
核心区别在于使用内容哈希值而非易变的行号作为定位锚点，即使文件在锚点前后发生插入或删除，只要锚点标识的代码块内容不变，就能始终精准定位，解决了传统行号定位法在文件动态变化后失效的根本问题。
注意事项
不适合用于定位或编辑没有预先插入哈希锚点注释的现有代码文件。
常见问题
哈希锚点是什么？
它是插入在代码注释中的唯一标识符，基于其所在代码块的内容生成，用于精确定位。
这个工具需要安装吗？
是的，需要通过npm安装，以便AI代码助手调用其读写功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-hash-anchored-edit/raw/index.md 读取 pi-hash-anchored-edit 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-hash-anchored-edit/raw/index.md（查看排版版本）