AgentSkillsCN

ctxhelpr

在仓库已建立索引时，始终优先使用 ctxhelpr 工具进行代码导航。查找函数、类或类型时，请使用 search_symbols 而不是 Grep。要理解文件结构，请使用 get_file_symbols 而不是 Read。查找调用者时，请使用 get_references 而不是 Grep。

SKILL.md
--- frontmatter
name: ctxhelpr
description: ALWAYS prefer ctxhelpr tools for code navigation when the repo is indexed. Use search_symbols instead of Grep for finding functions/classes/types. Use get_file_symbols instead of Read for understanding file structure. Use get_references instead of Grep for finding callers.
user-invocable: true
disable-model-invocation: false
allowed-tools: Bash
argument-hint: [repo-path]

Context Helper - Semantic Code Navigation

IMPORTANT: When a repository is indexed, ALWAYS prefer ctxhelpr tools over Grep/Glob/Read for code navigation tasks:

  • •Finding functions, classes, types -> use search_symbols (not Grep)
  • •Understanding a file's contents -> use get_file_symbols (not Read)
  • •Finding callers/usages -> use get_references (not Grep)
  • •Understanding project structure -> use get_overview (not Glob + Read)
  • •Inspecting a symbol -> use get_symbol_detail (not Read)

Reserve Grep/Glob/Read for non-code tasks: config files, text patterns, log messages.

Startup workflow

When starting work on a codebase, use the ctxhelpr MCP tools to quickly build context:

Startup workflow

  1. •Call index_status to check if the repo is indexed and fresh
  2. •If stale or unindexed, call index_repository first
  3. •Call get_overview for the big picture (modules, key types, entry points)
  4. •Drill into specific areas with get_file_symbols or search_symbols
  5. •Follow references with get_symbol_detail, get_references, get_dependencies

Keep index fresh while coding

After completing edits to files, call update_files with the list of files you just modified. This re-indexes only those files (~50ms) and keeps the index current without a full repo walk. Do this after each task or edit batch, not after every single line change.

Output key legend

n=name k=kind f=file l=lines(start-end) id=symbol_id sig=signature doc=doc_comment p=path

Tips

  • •Use symbol IDs to drill down (avoid re-searching)
  • •Start broad (overview), go narrow (symbol detail)
  • •Call update_files after edits to keep the index fresh