@neat.is/claude-skill

@neat.is/claude-skill 是 NEAT 项目面向 Claude Code 用户提供的 MCP 技能包，将 NEAT 实时语义分析图的全部能力以 16 个 MCP 工具的形式接入 Claude Code，让 AI 在编程时能够主动查询项目内部的服务依赖关系、运行时观测数据和策略合规状态，从而在面对复杂问题时优先「问图」而非暴力文本搜索，大幅提升代码理解与问题定位的效率。

这 16 个 MCP 工具分为两大类：十项只读查询工具，包括 get_root_cause（追溯故障节点的依赖链上游根因）、get_blast_radius（分析节点故障的下游影响范围）、get_dependencies（获取传递依赖关系，支持 BFS 深度遍历）、get_observed_dependencies（仅返回运行时实际观测到的依赖，与代码声明对比发现分歧）、get_incident_history（查询该节点最近的 OTel 错误事件）、get_divergences（发现代码声明与生产环境实际运行之间的差异，NEAT 最具特色的查询入口）、get_graph_diff（对比历史快照与当前实时图的差异）、get_recent_stale_edges（发现已停止上报数据的集成点）、check_policies（干运行策略检查，预判假设操作是否违反合规规则）、semantic_search（自然语言语义搜索项目图节点）。六项扩展工具则用于自动安装和管理 OTel 插桩，包括 neat_list_uninstrumented（列出还需插桩的库）、neat_describe_project_instrumentation（描述当前 OTel 状态）、neat_dry_run_extension（预览安装效果）和 neat_apply_extension（自动安装插桩包并写入 OTel hook 文件）。

除了工具接入，该 Skill 还包含两项行为引导机制：search-nudge PreToolUse Hook——当 Claude Code 准备用 Grep/Glob/Bash grep 时，自动注入提示引导 AI 优先使用语义搜索或图查询；GRAPH_FIRST.md——一段可粘贴到项目说明文档（CLAUDE.md、AGENTS.md、.cursorrules 等）的引导文本，让其他 AI 编程工具也能获得「先问图再搜索」的行为指导。安装方式极为简单：运行 neat skill --apply 即可自动合并 MCP 配置到 ~/.claude.json，无需手动编辑。