hashgraph-online GitNexus
用途
- 对存量仓库做更深代码图谱分析：符号上下游、调用链、执行流、跨仓影响面。
- 在改动前用
impact/detect_changes类证据确认 blast radius。 - 为
/team-plan、/team-execute、/team-review提供可追溯的 MCP/图谱证据。
触发信号
- brownfield 项目改动跨多个模块、服务或仓库。
- 需要回答“改这个 symbol/API 会影响谁”“这段流程从哪里进入、流向哪里”。
- 评审或发布前需要对 git diff 做影响面确认。
- Graphify 的轻量结构扫描不够，需要 MCP tool、资源或多仓上下文。
默认工作流
- 先跑
npm run gitnexus:doctor，确认 Node、npm/npx 与上游包元数据。 - 用户自行确认 GitNexus 上游许可证和项目使用场景是否匹配。
- 在目标项目根目录显式执行索引命令，并保留 TSP 的 AGENTS/CLAUDE 契约：
npx --yes gitnexus@latest analyze --skip-agents-md - 通过 MCP 或 CLI 查询
query/context/impact/detect_changes等结果。 - 把关键发现回落到主链：
- 规划阶段 ->
/team-plan的 Brownfield Context Snapshot 和 readiness 证据 - 执行阶段 ->
/team-execute的 story slice 影响面说明 - 评审阶段 ->
/team-review的风险、回归边界和放行建议
- 规划阶段 ->
输出约定
- GitNexus 索引由上游工具管理，通常写入目标仓库
.gitnexus/与用户级 registry。 - TSP 侧只沉淀结论，不沉淀上游数据库：
- 分析目标
- 查询入口（MCP tool/resource 或 CLI 命令）
- 核心发现
- 对
/team-*决策的影响 - 后续验证或回退建议
边界与禁用项
- 不把 GitNexus 当作 TSP 依赖或默认安装项。
- 不自动运行
gitnexus setup，避免改写用户全局 MCP/editor 配置。 - 不在 TSP 管理仓库里运行不带
--skip-agents-md的gitnexus analyze。 - 不复制 GitNexus 源码、hooks、skills 或生成产物到 TSP canonical source。
- 当前按上游 npm 元数据视为非商业许可证约束；商业使用前需要用户自行确认授权。
推荐组合
- 轻量 brownfield 结构扫描：
/team-help -> /update-codemaps -> graphify -> /team-plan - 深影响面分析：
/team-help -> /update-codemaps -> GitNexus impact/detect_changes -> /team-plan - 高风险评审：
/team-execute -> GitNexus detect_changes -> /handoff -> /team-review
Source: hashgraph-online/awesome-codex-plugins → plugins/Colin4k1024/tsp/skills/gitnexus/SKILL.md