mcpField
R
reindex

reindex

github.com/terrylica开发280 次安装2 天前更新
代码仓库

关于 reindex

GitNexus Reindex 是一项命令行技能，用于重建或更新仓库的 GitNexus 知识图谱，并核验状态和统计数据。它面向需要在重大改动后刷新索引，或处理索引过期提示的开发者。

主要功能

  1. 01对照 HEAD 检查索引状态
  2. 02执行增量分析
  3. 03强制完整重建索引
  4. 04核验更新后的索引状态
  5. 05报告索引统计数据

适用场景

  1. 01大型重构后刷新索引
  2. 02合并大型拉取请求后更新索引
  3. 03处理索引过期提示

MCP 相关

该技能明确说明不存在 MCP 服务，使用 GitNexus 命令行，而非 `gitnexus://` MCP 资源。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill reindex

安装后在 Claude Code 中输入/reindex确认已加载。

详细介绍

GitNexus 重新索引

仅限 CLI——不存在 MCP 服务。切勿对 gitnexus:// URI 使用 readMcpResource。

重新索引当前仓库的 GitNexus 知识图谱，并验证更新后的统计数据。

自进化技能：此技能会在使用中不断改进。如果指令有误、参数发生偏移或需要采用变通方法，请立即修复此文件，不要延后。仅针对真实、可复现的问题进行更新。

使用时机

  • 进行重大重构后（更改了 5 个或更多文件）
  • 过期检测钩子报告索引落后时
  • 合并大型 PR 后
  • “刷新知识图谱”

工作流

步骤 0：预检——确保 CLI 可调用

gitnexus 二进制通过 npm/mise 安装。如果当前项目未启用 node，mise shim 可能会失败。运行以下预检，然后再执行任何 gitnexus 命令：

# Test if gitnexus is actually callable (not just a broken shim)
gitnexus --version 2>/dev/null || mise use [email protected]

以下所有命令均在仓库根目录运行。如果工作区中索引了多个仓库，请添加 --repo <repo-name> 指定目标仓库。否则 --repo 可选。

步骤 1：检查当前状态
gitnexus status

如果索引已是最新（lastCommit 与 HEAD 匹配），则报告“索引已是最新”并停止。

步骤 2：运行索引器
gitnexus analyze

如果索引似乎已损坏，或常规分析未能检测到更改，请使用 --force：

gitnexus analyze --force

根据代码库规模，此过程可能需要 30–120 秒。

步骤 3：验证新索引
gitnexus status
步骤 4：报告统计数据

展示更新后的统计数据：

## GitNexus Reindex Complete

| Metric      | Before | After |
| ----------- | ------ | ----- |
| Nodes       | ...    | ...   |
| Edges       | ...    | ...   |
| Communities | ...    | ...   |
| Flows       | ...    | ...   |
| Last Commit | ...    | ...   |

Index is now current with HEAD.

备注

  • analyze 命令在本地运行，不会进行网络调用
  • KuzuDB 数据库存储在仓库根目录下的 .gitnexus/ 中
  • 大型代码库（10k+ 个文件）可能需要 2 分钟以上
  • --force 标志会从头重建；不使用时则会进行增量分析

执行后反思

此技能完成后，在结束任务前进行反思：

  1. 确认路径。——编辑前，找到此 SKILL.md 的规范路径。
  2. 哪里失败了？——修复导致问题的指令。
  3. 哪些地方比预期更有效？——将其列为推荐做法。
  4. 哪些内容发生了偏移？——修复任何与实际情况不符的脚本、引用或依赖项。
  5. 记录下来。——添加演进日志条目，记录触发原因、修复内容和证据。

切勿延后。下次调用时会继承你留下的一切。

评论

支持 Markdown