Context Mode 上下文索引构建

Model: qwen-max | ¥0.15/call

工程方法论GPT-4.1工程实践上下文索引构建

上下文索引构建：mksglu/context-mode: ctx-index，适用于工程实践、代码质量与开发流程优化。

Calls: 1

Skill Documentation

Context Mode 上下文索引构建

摘要

上下文索引构建：mksglu/context-mode: ctx-index，适用于工程实践、代码质量与开发流程优化。

> 来源: mksglu/context-mode (19.7k stars) — Claude Code 上下文窗口优化

> 原文件: skills/ctx-index/SKILL.md

> 模型推荐: gpt-4.1 (工具/查询类)

这个 skill 是干嘛的

mksglu 在 19.7k stars 的 context-mode 仓库里整理的"上下文窗口优化"工具集 — 通过 sandbox 输出压缩(98% reduction)、会话记忆持久化、17 平台路由,让 Claude 在长对话中保持高效。

michael 强调"skill 要有相应的指导功能,指导用户使用",所以加了下面两节让 Agent 和用户对接。

---

🤖 Agent 使用说明

1. 用户提到"上下文 / context / 长会话 / 记忆"时触发

2. skill 会按"压缩 → 持久化 → 检索"流程跑

3. 涉及外部存储前 ask user 确认

4. 完工后让 Agent 跑自检

👤 用户需要做什么?

1. 告诉 Agent 你要管理什么对话(长会话 / 项目 / 知识库)

2. 如果需要外部存储 / API key,按提示提供

3. 全程 Agent 自动化,你只需回答授权类问题

---

原 skill 内容(mksglu/context-mode/skills/ctx-index/SKILL.md,截断到 12k chars)

---

name: ctx-index

description: |

Index a local file or directory into context-mode's persistent FTS5 knowledge base

so future ctx_search calls can retrieve focused snippets without rereading raw files.

Trigger: /context-mode:ctx-index

user-invocable: true

---

Context Mode Index

Index local project content for later search.

Instructions

1. Prefer the `ctx_index` MCP tool when it is available.

2. Ask for a path only if the user did not provide one and the current project root is ambiguous.

3. Use `path`, not large inline `content`, so file bytes do not enter the conversation.

4. For repository indexing, pass conservative bounds and a clear source label:

ctx_index({
  path: ".",
  source: "project:<name>",
  maxDepth: 5,
  maxFiles: 200
})

5. If MCP tools are unavailable, fall back to the CLI:

context-mode index . --source project:<name>

6. Report the indexed source label, file count or section count, and the matching search command:

ctx_search({ source: "project:<name>", queries: ["..."] })

Safety

Do not index dependency directories, build outputs, secrets, or generated artifacts.
Prefer `--exclude` or `exclude` for project-specific noisy paths.
For broad repos, ask the user before raising `maxFiles` above 500.

常见问题（FAQ）

使用「上下文索引构建」这个 skill 能解决什么问题?

本 skill 专注于上下文索引构建，mksglu/context-mode: ctx-index。它将相关流程标准化，帮助用户更快拿到可靠结果，减少重复手工操作。

什么情况下适合使用「上下文索引构建」?

当你需要在上下文索引构建相关工作中获得稳定、可复用的产出时最适合——无论是单次任务还是纳入日常工作流，都能直接调用。

使用「上下文索引构建」前需要准备什么?

需要一个具体的项目或任务上下文，最好带有代码仓库或需求文档。

FAQ