SuperAPI AI 工具集

setup-ast

测试与质量

查看项目

更新于 10-16 08:39

技能介绍

用途:诊断并配置 tree-sitter,使其能为基于 AST 的代码提取与代码审查提供支持。当 AST 提取失败、找不到 tree-sitter、语法(grammar)缺失或需要初始化时使用。

主要能力:提供非交互式脚本与交互式流程两种方式。非交互式脚本:./scripts/setup-tree-sitter.sh(核心语法)、./scripts/setup-tree-sitter.sh --all(全部语法)、./scripts/setup-tree-sitter.sh --status(检查状态)。交互式流程按 GROUND → DETECT → PLAN → INSTALL → VERIFY 推进,并强制先诊断、最后验证,每步创建任务跟踪进度。

使用方式:先诊断当前状态,检查 CLI(command -v tree-sitter && tree-sitter --version)、语法目录(GRAMMAR_DIR="${TREE_SITTER_GRAMMAR_DIR:-$HOME/repos/tree-sitter-grammars}")与提取状态(./agents/extract-units.sh --status),并检查 shell 配置中的 TREE_SITTER_GRAMMAR_DIR。再扫描项目语言,按扩展名映射到对应语法仓库。随后安装 CLI(macOS 用 brew install tree-sitter;Linux/其他用 cargo install tree-sitter-cli),创建目录 mkdir -p ~/repos/tree-sitter-grammars,克隆并构建语法(tree-sitter generate),设置环境变量 export TREE_SITTER_GRAMMAR_DIR="$HOME/repos/tree-sitter-grammars",最后验证解析。

适用场景:需要为代码审查准备 AST 提取环境,或修复语法缺失、路径错误、CLI 版本不匹配等问题。

限制:诊断与验证为强制步骤,不可跳过;盲目安装可能覆盖可用语法或产生重复安装。部分语法不含查询文件(如 tags.scm),需手动处理;部分语法要求特定 CLI 版本。具体收费、价格与平台支持资料暂未提供。