用途:让仓库的编码代理具备 CodeGraph 语义范围与 ast-grep CLI 结构证据能力。适用于安装/协调 CodeGraph、ast-grep CLI、MCP 暴露、索引与代理指引;更新分析栈并执行配置、索引或 schema 迁移;诊断缺失、过期、断开或疑似损坏的配置(不修复)。不用于依赖审计、编译器/运行时证明或未经审查的大范围重写。
工作流:setup 安装缺失组件、连接编码客户端、构建代码索引、添加仓库指引,并安全复用或修复现有配置;update 将现有配置更新到当前稳定版本而不改变安装方式,必要时迁移配置或索引数据,重连客户端并验证;doctor 诊断健康状态并报告分析数据,不执行修复。无 auto 工作流,按意图选择:明确安装选 setup,明确稳定工具更新/迁移/刷新选 update,报故障或健康检查选 doctor,意图模糊需列出三者请用户选择。代理发起的激活只能选 doctor。
用法:检查仓库根、嵌套仓库/单体包、包策略与受保护 Git 状态;检查 CODEGRAPH_DIR(默认 .codegraph/)、根 codegraph.json、sgconfig.yml/sgconfig.yaml 与仓库指令文件;通过仓库批准的安装通道和范围协调稳定版 CodeGraph 与 ast-grep CLI,不安装实验性 ast-grep MCP 服务器;配置运行时客户端与项目根,执行初始化及必要迁移;持久化简洁指引,说明用 CodeGraph 查语义符号、调用者、调用路径与影响,用 ast-grep CLI 查结构语法证据,广泛编辑前先协调两者。
限制:ast-grep CLI 为默认支持方式,实验性 MCP 服务器排除在正常 setup 外;技能驱动的检查与批准的 setup/update 命令需以 CODEGRAPH_TELEMETRY=0 抑制遥测;优先精确包或校验和发布资产,默认不用管道安装;不发明 .codegraph/config.json;不假设自动同步;不应用未测试的 ast-grep 重写;持久或公开产物中需脱敏。核心工具均非编译器、类型、污点或运行时证明。无运行时脚本。