mcpField
C
ctx-index

ctx-index

github.com/mksgluAgent 工作流32.7k1.1k 次安装今天更新
代码仓库

关于 ctx-index

ctx-index 是用于建立本地项目内容索引以供后续搜索的技能,可使用 `ctx_index` MCP 工具或 `context-mode` 命令行。它通过文件数和深度限制、排除嘈杂或敏感路径来指导安全索引,并报告来源和计数。

主要功能

  1. 01索引本地项目内容
  2. 02优先使用 `ctx_index` MCP 工具
  3. 03不可用时改用命令行
  4. 04设置范围并排除路径
  5. 05报告来源和索引计数

适用场景

  1. 01为后续搜索准备代码库
  2. 02避免索引机密或生成文件

MCP 相关

优先使用 `ctx_index` MCP 工具为路径建立索引;若 MCP 工具不可用,则使用 `context-mode index` 命令行命令。

安装

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

$npx skills add https://github.com/mksglu/context-mode --skill ctx-index

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

详细介绍

Context Mode 索引

为后续搜索索引本地项目内容。

说明

  1. 如果 ctx_index MCP 工具可用,请优先使用。

  2. 仅当用户未提供路径且当前项目根目录不明确时,才询问路径。

  3. 使用 path,而不是较大的内联 content,以免文件字节进入对话。

  4. 为仓库建立索引时,请传入保守的边界值和清晰的来源标签:

ctx_index({
  path: ".",
  source: "project:<name>",
  maxDepth: 5,
  maxFiles: 200
})
  1. 如果 MCP 工具不可用,请改用 CLI:
context-mode index . --source project:<name>
  1. 报告已索引的来源标签、文件数或章节数,以及用于匹配的搜索命令:
ctx_search({ source: "project:<name>", queries: ["..."] })

安全

  • 不要索引依赖目录、构建输出、机密信息或生成的构件。
  • 对于项目特有的嘈杂路径,优先使用 --exclude 或 exclude。
  • 对于大型仓库,在将 maxFiles 提高到 500 以上之前,请先询问用户。

评论

支持 Markdown