SuperAPI AI 工具集

repomix-context-skill

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:当智能体需要从本地 repomix 索引中获取源码时使用。索引位于 .terrain/agent/repomix.md,未纳入版本控制,可通过 Terrain scan 重新生成。架构问题应先通过 terrain-knowledge-skill 读取 .terrain/agent/context.md。

主要能力:在已索引快照内做跨文件符号搜索,定位处理器、类型、路由,查看实现细节。

必要用法:先读取 .terrain/agent/meta.json,查看 total_tokens、synced_at、top_files_by_tokens。不要在未检索的情况下加载整个文件。查询时使用 rtk:<rtk> 指 ~/.terrain/bin/rtk 或 bunx @terrain-ai/rtk,示例如 <rtk> grep "struct ProjectOverview" .terrain/agent/repomix.md 或 <rtk> grep "### src/lib/api.ts" .terrain/agent/repomix.md;也可用智能体 Grep 限定路径并使用精确模式。读取时只提取匹配的 ### path/to/file 段,可先执行 <rtk> read .terrain/agent/repomix.md -l aggressive,再读取具体文件块的行范围,每次不超过 150 行。若 meta.json 的 synced_at 过期,请用户运行 Terrain 重建源码索引或 scan。

索引格式:文件段以 ### relative/path 开头,后接带语言标记的代码围栏。可用 grep "### relative/path" 跳转到文件。相关文件包括 .terrain/agent/repomix.md、.terrain/agent/meta.json、.terrain/agent/context.md。

限制:不要提交 repomix.md,也不要假设它在 git 中存在;不要 cat 或读取整个文件(可能超过 10 万 token);当索引已覆盖问题时应读取该索引而非实时仓库树;架构问题不要跳过 context.md 直接 grep 源码。若 repomix.md 缺失,可在仓库根执行 ~/.terrain/bin/terrain assets pack-agent .,否则用 bunx @terrain-ai/cli assets pack-agent .,或在 Terrain UI 中选择“重建源码索引”。若两者均不可用,请用户安装 Terrain 或从桌面应用执行重建。相关技能:codegraph-skill(符号关系,建议在宽泛 repomix grep 之前使用)、rtk-skill(解析 <rtk> 前缀)。