用途:为当前代码库构建或更新 .gauntlet/graph.db 代码知识图谱,在搜索或 blast-radius 分析前建立代码结构认知。
主要能力:解析 20 多种语言(含 Python、JavaScript、TypeScript、Go、Rust、Java、C/C++、Ruby、PHP),提取节点(File、Class、Function、Type、Test)与边(CALLS、IMPORTS_FROM、INHERITS、CONTAINS、IMPLEMENTS、TESTED_BY)。数据库为 SQLite(WAL 模式),自动创建 .gauntlet/.gitignore 防止提交;增量更新用 SHA-256 哈希跳过未变文件。
使用方式:先检测目标目录(当前工作目录或用户指定路径);若 .gauntlet/graph.db 已存在则增量更新,否则全量构建。全量:python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir>;增量:python3 ${CLAUDE_PLUGIN_ROOT}/scripts/graph_build.py <dir> --incremental。完成后展示 JSON 输出(files_parsed、nodes_created、edges_created、duration),并建议搜索图谱或做 blast-radius 分析。
适用场景:会话开始建立结构认知、重大代码改动后更新图谱、运行影响面分析或流程追踪前、用户询问代码库结构时。
限制:不用于查询已存在的图谱(改用 gauntlet:graph-search),也不用于构建挑战知识库(改用 gauntlet:extract)。