SuperAPI AI 工具集

generating-lattice

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:生成并维护 lat.md/ 知识图谱——结构化、交叉引用、锚定到源码符号的 Markdown 文档,由 lat CLI 校验,在代码或文档变化时捕获文档漂移。

主要能力:双向链接。自上而下(文档→代码)用 [[src/auth.js#getValidToken]] 指向具体符号,符号重命名或删除时 lat check 报错;自下而上(代码→文档)用 // @lat: [[auth#Token Refresh]] 注释回指概念,章节改名或删除时同样被捕获。缺少任一方向,图谱就会静默漂移。

依赖与安装:需 tree-sitting 技能,其 AST 扫描是 LLM 辅助编写的输入。安装:npm install -g lat.md,lat --version 验证(需 Node.js 22+)。CLI 提供 lat check、lat search、lat section、lat refs、lat mcp。

生成流程:1)结构扫描,用 tree-sitting 获取符号清单,不写盘;2)选择性阅读源码,只读含设计理由的文件;3)生成锚定章节,每节首段 ≤250 字符,用 [[src/path/file.ext#symbolName]] 锚定,支持 .ts/.tsx/.js/.jsx/.py/.rs/.go/.c/.h,类方法用 [[src/server.ts#App#listen]];4)在源码加 @lat: 回链,可运行 python3 SKILL_DIR/scripts/suggest_backlinks.py /path/to/repo,加 --apply 自动应用;5)运行 lat check 校验 md、code-refs、sections、index 四项;6)配置代理集成,如 lat.md/.gitignore 排除 .cache/,在 CLAUDE.md 追加 lat:begin/lat:end 指令块,或运行 lat init 设置钩子。

适用场景:需要文档与代码保持同步、可追溯的代码库,尤其测试规格、不变量、关键业务规则可用 require-code-mention: true 强制每个叶子章节都有对应 @lat: 注释。

限制:新代码无文档、新文档无锚点不会被自动捕获,除非启用 require-code-mention;钩子需 lat 二进制的绝对路径,属机器本地配置。资料未提供收费、价格与平台信息。