SuperAPI AI 工具集

quality-detect-orphaned-code

测试与质量

查看项目

更新于 10-15 20:35

技能介绍

用途:在标记功能完成、将 ADR 从进行中改为已完成、创建新 Python 模块、重大重构、提交前质量门禁或代码审查时,检测存在但从未在生产代码中使用的代码,防止“已创建但未集成”的失败模式。

主要能力:检测孤儿模块(从未被生产代码导入的 Python 文件)、孤儿函数(已定义但从未被调用)、孤儿类(已定义但从未实例化)、孤儿 LangGraph 节点(节点工厂存在但未加入图)、死代码路径(已接线但条件永不触发)。它补充 vulture、mypy、pytest、ruff 等工具,因为这些工具可能被测试导入或仅检查类型、覆盖率、风格而漏掉集成问题。

使用方式:可用 grep 快速检查,例如 grep -r "from.*your_module import|import.your_module" src/ --include=".py" | grep -v test,输出为空即孤儿;也可运行脚本 ./scripts/verify_integration.sh 做全面检测,或用 ./scripts/check_imports.sh <module_name> 检查模块、./scripts/check_callsites.sh <function_name> 检查函数调用点。LangGraph 场景可运行 uv run pytest tests/integration/test_graph_completeness.py -v。可将检测加入提交前质量门禁、ADR 完成清单和 CI/CD 流水线。

适用场景:Python 项目、LangGraph 图构建、功能完成前验证、重构后检查、代码审查。

限制:资料未提供具体安装命令、收费信息、支持平台或性能数据;检测依赖 grep 与脚本,可能受动态导入、反射调用等影响,需人工复核可疑结果。