Heimdall Skill 技能

Heimdall 是一款为 AI 编码代理设计的自愈式知识层，旨在解决"代理重复造轮子"的问题。每个 AI 编程会话都从零开始，无法回答"我之前在另一个项目里是否已经解决过这个问题"——答案存在于不同的目录、以不同的描述性文本呈现、在你从未打开过的路径下。其结果是同一份工作被重建了三次。

Heimdall 通过监控代理的操作来维护跨项目的语义记忆图，并对每次搜索结果标注信任等级：STRONG 表示文件存在于磁盘、词汇覆盖强、文件实际内容回答了查询；WEAK 表示仅语义匹配，可信但未验证；REBUILT 表示文件已移动，系统已自动重新锚定；STALE/REMOVED 表示路径已失效，已被记录和剪枝。代理在失效路径上行动比没有答案更糟糕，正是信任 verdicts 使得知识图谱足够可信、值得代理依赖。

系统采用单写者架构，通过 O_EXCL 锁保证每个图谱变更的原子性，避免了删除后再插入导致的竞态窗口。每个节点和边精确归属于特定路径，提交时以事务方式删除并重新插入，确保删除的符号不会残留为幽灵节点。内容哈希作为唯一真实来源，使两次并发编辑等价于一次，是并发编辑无害而非仅仅是低概率碰撞的原因。

Heimdall 支持 Pi、Claude Code、Codex CLI、Cursor 和 Windsurf 等主流 AI 编程代理。通过 heimdall init --harness 命令将知识层接入现有工具链，安装后代理在每次编程时会自动同步记忆并在搜索前先查询知识库，避免重复工作。MIT 许可证，Node ≥ 22.5、bash、python3 即可运行。