AGENT SKILL

gitnexus

将 GitNexus 作为受控可选代码智能能力接入,用于 brownfield MCP 查询、影响面分析、 detect_changes、多仓分析和更深代码图谱证据。输出必须回落到 `/team-*` 主链和 artifacts。

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
gitnexus
origin
abhigyanpatwari/GitNexus (reference-only controlled integration)
description
将 GitNexus 作为受控可选代码智能能力接入,用于 brownfield MCP 查询、影响面分析、 detect_changes、多仓分析和更深代码图谱证据。输出必须回落到 `/team-*` 主链和 artifacts。

02 资源文件 1

03 SKILL.md 正文

GitNexus

用途

  • 对存量仓库做更深代码图谱分析:符号上下游、调用链、执行流、跨仓影响面。
  • 在改动前用 impact / detect_changes 类证据确认 blast radius。
  • 为 /team-plan、/team-execute、/team-review 提供可追溯的 MCP/图谱证据。

触发信号

  • brownfield 项目改动跨多个模块、服务或仓库。
  • 需要回答“改这个 symbol/API 会影响谁”“这段流程从哪里进入、流向哪里”。
  • 评审或发布前需要对 git diff 做影响面确认。
  • Graphify 的轻量结构扫描不够,需要 MCP tool、资源或多仓上下文。

默认工作流

  1. 先跑 npm run gitnexus:doctor,确认 Node、npm/npx 与上游包元数据。
  2. 用户自行确认 GitNexus 上游许可证和项目使用场景是否匹配。
  3. 在目标项目根目录显式执行索引命令,并保留 TSP 的 AGENTS/CLAUDE 契约:
    npx --yes gitnexus@latest analyze --skip-agents-md
    
  4. 通过 MCP 或 CLI 查询 query/context/impact/detect_changes 等结果。
  5. 把关键发现回落到主链:
    • 规划阶段 -> /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

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k