Indexion KGF 规范调试
将以下提示词粘贴到你的 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 规则、需要对照事件顺序与文档挂载位置的解析器作者