技能 context-tools

🗺️

context-tools

Name: context-tools
Author: ChipFlow

安全 ⚙️ 外部命令🌐 网络访问📁 文件系统访问🔑 环境变量

Map your codebase for Claude

Claude struggles to understand large codebases without proper structure. This skill provides automatic project mapping, symbol indexing, and duplicate detection so Claude can find functions, classes, and files instantly without slow grep searches.

支持: Claude Codex Code(CC)

🥉 76 青铜

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“context-tools”。 Find all functions that start with 'parse_'

预期结果:

Found 5 functions matching 'parse_*':
- parse_config (src/config/loader.py:42) - Parse configuration file and return settings
- parse_arguments (src/cli/args.py:15) - Parse command line arguments
- parse_timestamp (src/utils/time.py:78) - Parse ISO timestamp string
- parse_response (src/api/client.py:203) - Parse API response JSON
- parse_template (src/templating/engine.py:31) - Parse template file

正在使用“context-tools”。 Show me the structure of this Python project

预期结果:

Project Structure:
- Languages: Python
- Build system: uv
- Entry points: src/main.py, src/cli.py
- 45 classes, 120 functions indexed
- Documentation coverage: 84%

安全审计

安全

v5 • 1/16/2026

This is a legitimate open-source Claude Code plugin for codebase navigation. The static analyzer reported 606 potential issues with a NEEDS_AI recommendation, but all findings are false positives. Documentation examples using backticks and shell commands were incorrectly flagged as executable code. Common words like 'command' and 'control' were misidentified as C2 indicators. Standard development patterns (subprocess, sqlite3, file I/O) with hardcoded arguments were incorrectly flagged. The project is well-maintained with clear intent for codebase mapping and symbol search.

已扫描文件

6,868

分析行数

发现项

审计总数

风险因素

⚙️ 外部命令 (376)

🌐 网络访问 (12)

CHANGELOG.md:5 CHANGELOG.md:6 CHANGELOG.md:216 CHANGELOG.md:217 CHANGELOG.md:218 CHANGELOG.md:219 CHANGELOG.md:220 README.md:3 README.md:3 README.md:77 README.md:106 skill-report.json:6

📁 文件系统访问 (68)

commands/debug.md:14 commands/debug.md:18 commands/debug.md:27 commands/debug.md:29 commands/debug.md:29 commands/debug.md:39 commands/debug.md:58 commands/debug.md:69 commands/learnings.md:9 commands/learnings.md:9 commands/repo-map.md:11 commands/repo-map.md:14 commands/repo-map.md:17 commands/repo-map.md:19 commands/repo-map.md:41 commands/repo-map.md:49 commands/setup-mcp.md:56 commands/setup-mcp.md:25 commands/setup-mcp.md:25 commands/setup-mcp.md:32 commands/setup-mcp.md:56 commands/status.md:13 commands/status.md:19 commands/status.md:25 commands/status.md:45 commands/status.md:74 PROCESS-ARCHITECTURE.md:105 PROCESS-ARCHITECTURE.md:106 PROCESS-ARCHITECTURE.md:107 README.md:30 README.md:30 README.md:262 README.md:263 README.md:264 scripts/check-cache.sh:9 scripts/check-cache.sh:12 scripts/check-cache.sh:60 scripts/check-cache.sh:61 scripts/check-cache.sh:62 scripts/check-cache.sh:77 scripts/check-cache.sh:78 scripts/check-cache.sh:79 scripts/check-cache.sh:18 scripts/check-cache.sh:29 scripts/check-cache.sh:29 scripts/check-cache.sh:44 scripts/check-cache.sh:54 scripts/check-cache.sh:63 scripts/check-cache.sh:80 scripts/generate-manifest.py:559 scripts/on-exit.sh:9 scripts/on-exit.sh:11 scripts/session-start.sh:10 scripts/session-start.sh:22 scripts/session-start.sh:32 scripts/session-start.sh:42 scripts/session-start.sh:65 scripts/session-start.sh:69 scripts/session-start.sh:72 scripts/session-start.sh:100 scripts/session-start.sh:109 servers/repo-map-server.py:19 servers/repo-map-server.py:619 servers/repo-map-server.py:622 servers/repo-map-server.py:622 servers/repo-map-server.py:625 TESTING.md:171 TESTING.md:172

🔑 环境变量 (4)

commands/resolve-clashes.md:63 commands/resolve-clashes.md:65 servers/repo-map-server.py:61 TODO.md:186

审计者: claude 查看审计历史 →

质量评分

架构

100

可维护性

内容

社区

100

安全

100

规范符合性

你能构建什么

Explore complex codebases

Quickly find functions, classes, and methods by name pattern without slow grep searches across thousands of files

Map polyglot projects

Automatically detect build systems, entry points, and structure in Python/Rust/C++ projects

Find duplicate code

Identify similar classes and functions that may need consolidation or better documentation

试试这些提示

Find a function

Use mcp__repo-map__search_symbols to find all functions matching the pattern 'setup_*' in this codebase

List file contents

Use mcp__repo-map__get_file_symbols to show me all classes and functions defined in src/utils.py

Get function source

Use mcp__repo-map__get_symbol_content to get the complete source code for the 'User' class

Find files by pattern

Use mcp__repo-map__list_files to find all Python files matching the pattern '**/models/*'

最佳实践

Run repo-map after adding new files to keep the index current
Record important discoveries in .claude/learnings.md before session ends
Use MCP tools instead of grep for finding functions and classes
Review similar class/function warnings to identify code duplication

避免

Using grep/find to search for function names when MCP tools are available
Ignoring the learnings reminder before context compaction
Skipping repo-map regeneration after major refactoring
Running MCP queries without checking if indexing is complete

常见问题

What languages does this support?

Python, Rust, and C++ (.cpp, .cc, .cxx, .hpp, .h, .hxx). Other languages are not parsed.

How fast are MCP symbol searches?

MCP tools query a pre-built SQLite index, making them 10-100x faster than grep on large codebases.

Does this work with multiple projects?

Yes. Each project has its own .claude/repo-map.db. MCP tools automatically adapt to your current directory.

Is my code data safe?

Yes. All data stays local. No network calls are made. Index files are stored only in your project's .claude directory.

Why is the first query slow?

On first use, the MCP server indexes your codebase in the background. Subsequent queries return instantly from the SQLite index.

How is this different from Search/Grep tools?

Search/Grep scan file contents. MCP tools query a pre-indexed symbol database designed specifically for finding functions, classes, and methods by name.