SuperAPI AI 工具集

ultraindex-nav

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:在已有 ultraindex 索引的大型仓库中导航,只打开任务真正需要的文件,而不是把整个仓库读入上下文。核心原则是加载最小内容。

主要能力:通过 node scripts/ultraindex.mjs 提供多个子命令。check 检查索引是否存在及是否过期;map 打印 INDEX.md,给出项目摘要、枢纽模块与模块表;find 按任务关键词返回相关模块及其确切源文件、匹配词和图邻居;neighbors 沿图扩展,查看某文件或模块还关联什么;ask 针对代码库问题收集证据,打印相关模块的真实源码(含行号)及应打开的文件。

使用方式:先定位索引目录(默认 .ultraindex/,或 docs/ultraindex/),再运行 check --out <index-dir>。若索引缺失,应提示用户先用生成器技能构建(node scripts/ultraindex.mjs build --repo <repo>)并停止,不要自动构建;若过期则继续但提醒结果可能略旧并建议重建。随后用 map 做一次低成本定位,用 find 找到相关文件,逐个打开列出的 encyclopedia/<module>.md 条目和具体源文件,够用即停。回答代码库问题时,用 ask 组装证据,把答案写入 ANSWER.md,每条论断用裸方括号引用 [file]、[file:line] 或 [file:start-end],再用 check --answer ANSWER.md --out <index-dir> 验证引用可解析,未通过不得给出答案。

适用场景:大型仓库中的代码定位、任务执行前的文件筛选、基于真实代码的问答。

限制:本技能对索引只读,不负责刷新或丰富索引,那是生成器技能的职责;不读取 graph.json 或整个 encyclopedia/ 目录;无需 npm install 和密钥;索引缺失时不能自动构建。具体平台、收费与价格信息暂未提供。