用途:在代码库中查找孤立函数、悬空导入、孤立文件和不可达代码,基于 GitNexus 知识图谱做跨文件结构分析。适合定期清理代码、发布前缩减代码面、重构后排查新产生的孤立代码,或回答“有没有未使用的函数”。语言专用工具(vulture、knip、clippy)应改用 quality-tools:dead-code-detector。
使用方式:仅 CLI,不存在 MCP 服务器,不要使用 gitnexus:// URI 的 readMcpResource。所有命令在仓库根目录执行;工作区索引多个仓库时可加 --repo <repo-name>。先做预检:gitnexus --version 2>/dev/null || mise use node@25.8.0。用 gitnexus status 检查索引,若索引提交与 HEAD 不一致则直接执行 gitnexus analyze 重建,再确认状态。随后用 gitnexus cypher 运行四类查询:无入边 CALLS 且不参与流程的孤立函数;confidence 小于 0.5 的悬空导入;无调用者且无流程归属的不可达函数;无进出 IMPORTS 的孤立文件。
结果过滤:排除测试文件、init 文件、入口点(main、cli、main)以及下划线前缀的私有辅助函数等误报,再按模块或目录输出分类报告,含孤立函数、悬空导入、孤立文件及汇总数量。
限制:结果依赖索引新鲜度,异常时需重建索引;图谱只反映静态关系,动态派发、反射和插件加载可能造成误报。该技能自称可自我演进,遇到可复现问题应直接修正本文件并记录演进日志。