用途:在修改调用方较多的函数前,评估“改动 X 会破坏什么”“修改 Y 是否安全”“Z 的影响面有多大”。
主要能力:通过 gitnexus CLI 分析符号的上游影响面(调用者及最多指定深度的传递调用者)、下游依赖、参与的流程以及测试覆盖情况,并据此给出风险等级与建议。
使用方式:所有命令在仓库根目录执行;工作区索引了多个仓库时可加 --repo <repo-name>。先做预检:gitnexus --version 2>/dev/null || mise use node@25.8.0。用 gitnexus status 检查索引,若索引提交与 HEAD 不一致则先执行 gitnexus analyze 并复查状态。上游影响面:gitnexus impact "<symbol>" --depth 3;候选多个时用 --uid "<full-uid>" 或 --file "<file-path>" 消歧。下游依赖:gitnexus impact "<symbol>" --direction downstream --depth 3。测试覆盖:gitnexus impact "<symbol>" --include-tests。
风险参考:直接依赖 <5 为 LOW,5–20 为 MEDIUM,20–50 为 HIGH,50+ 为 CRITICAL,分别对应基本测试、审查调用方并跑相关测试、考虑向后兼容 API 与充分测试、制定弃用与分阶段迁移策略。最后输出结构化报告:风险等级与依赖数、受影响的主要流程、直接调用者、测试覆盖或缺口、修改建议。
限制:仅 CLI,无 MCP 服务器,不要用 readMcpResource 读取 gitnexus:// URI;gitnexus 由 npm/mise 安装,mise shim 在 node 未激活时可能失败,需先执行预检命令。该技能为自演进型,遇到可复现的指令错误、参数漂移或必要变通时应立即修正本文件并记录演进日志。具体安装细节与更多参数暂未提供。