SuperAPI AI 工具集

codependix-navigate

通用与其它

查看项目

更新于 10-16 03:12

技能介绍

用途:回答“X 如何到达 Y”“改动 Z 会影响什么”“某包依赖什么”等依赖与架构问题,可查询依赖关系或读取磁盘上已提交的图。

主要能力:codependix path 追踪两个节点间的有向依赖路径,例如 codependix path project-a project-c、codependix path src/modules/auth/auth.service.ts src/modules/users/user.entity.ts、codependix path AuthModule DatabaseModule。支持四种图:Nx Neighborhood(项目一跳依赖与影响范围)、Workspace graph(跨包架构分层)、NestJS module graph(DI 容器装配)、File import graph(项目内文件导入、循环与重构影响)。

使用方式:优先读取已提交图(各项目 README 的 ## 🕸️ Codependix 段或 <!-- codependix:start name="..." --> 标记,根 README 含工作区图)以零构建成本回答单跳依赖、影响范围或本地文件布局;多跳传递路径、跨项目可达性、验证未暂存改动或生成机器可读 JSON 时运行 codependix path。可用 -f/--format(markdown 默认、json、mermaid)、--nx-projects/--no-nx-projects、--file-imports/--no-file-imports、--nestjs-modules/--no-nestjs-modules、--projects、-d/--directory、--include/--exclude、--tags、--config 缩小范围。检查图是否过期:codependix map --check reports;更新:codependix map --write。

限制:全工作区运行成本高,因需解析 Nx 项目、TypeScript AST 与容器注册;无路径时报告 No path connects "<from>" to "<to>". 或 JSON 空列表并退出 0,属答案而非错误;文件导入图仅含同项目内文件边,isolatedFileNames 是待查清单而非死代码;已提交图反映上次 codependix map --write 状态,本地编辑后可能过期。其余细节暂未提供。