Agent Skills
返回列表
💻

Indexion KGF 规范调试

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/trkbt10-indexion-skills-indexion-kgf。

技能介绍

你在纠结什么

indexion 用 KGF(语法描述文件)决定怎么 分词、怎么产生 解析事件、最后抽出哪些 依赖边。真正动手改 .kgf 或排查「这个文件为什么没被正确理解」时,光看 grep 结果往往不够:模式别名来自 === lex 段,匹配失败也未必能直接看出是 token 种类不对还是规则顺序吃掉了声明前的文档注释。

技能帮你做什么

本技能围绕 indexion kgf 子命令组织说明,把整条流水线拆开给你看:

  • indexion kgf inspect:一次性输出 tokens、events、edges,适合先建立全局图景
  • tokens / events / edges:分别只看分词、事件、边,便于 pinpoint 哪一段出了问题
  • list / update / add:管理已安装 spec 与从 GitHub 拉最新定义
  • 常用选项 --spec=NAME、--kgf-dir=PATH:在多 spec 或自定义目录下强制指定解析上下文

与 indexion grep 的关系写得很清楚:grep 底层走同一套 tokenization。pattern 对不上时,应对照 MoonBit 等语言里常见的 KW_*、Ident、TypeIdent、括号与 NL/SKIP(空白在 grep 里会被滤掉)等 token kinds,而不是一味改正则。

技能还给出一套 KGF 编写踩坑 备忘:PEG 先匹配获胜 导致 DocComment 抢在声明规则前;源码里 doc 与关键字之间的 换行 需要 NL?/NL*;事件 自底向上 触发时如何用 bind/$scope 把子规则数据传给父规则;token 定义顺序 让通用 Operator 吃掉 = 等。改完 spec 后应用 edges 里的 declares 验证文档是否挂上。

边界与注意点

这是 检视与调试 KGF / indexion 解析行为 的指南,不是替代阅读官方 indexion 文档或手写完整语言 spec 的教程。若问题在业务代码语义而非 token/PEG 规则,需要回到语言本身或其它工具链。

使用场景

  • 为 MoonBit 等新语言改 `kgfs/*.kgf` 后,用 inspect 对照源码确认 token 与 declares 边是否符合预期
  • grep 搜 `pub fn` 无结果时,用 kgf tokens 查看实际是 `KW_pub` 还是被 SKIP/NL 拆开
  • 排查某文件依赖边缺失,先 events 再看 edges,判断是解析规则没触发还是 bind/scope 没传到父节点
  • 协作维护多份 KGF spec 时,用 list/update 统一版本再对单个文件跑 tokens 做单点验证

适合人员

  • 维护 indexion 语言包、需要手写或 fork KGF 的底层工具贡献者
  • 在大型 monorepo 里用 indexion grep 做代码导航,却经常遇到模式与 lexer 不一致的后端工程师
  • 正在为自制 DSL 或内部语言写 PEG 规则、需要对照事件顺序与文档挂载位置的解析器作者