SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场nav-graph

nav-graph

智能体与模型

查看项目

更新于 10-25 16:17

技能介绍

用途

nav-graph 是 Navigator v6.0.0 引入的项目知识图谱（Project Knowledge Graph）技能，用于查询和管理跨任务、SOP、系统文档与经验记忆的统一知识库。它解决三类问题：跨所有知识类型的统一搜索；让模式、陷阱、决策、学习等经验性记忆持久保存；按上下文只加载相关知识（约 1-2k tokens），并支持沿关系遍历查找相关概念和文档。

主要能力

  • 查询（QUERY）：按概念检索知识，返回任务、记忆、SOP、文件等分组结果。触发语句如“What do we know about X?”“Show everything related to X”“Any pitfalls for X?”“What decisions about X?”“Find all knowledge about X”。
  • 记忆捕获（CAPTURE）：根据用户表述创建记忆节点，类型包括 pattern、pitfall、decision、learning。触发语句如“Remember this pattern/pitfall/decision/learning: …”。
  • 图谱管理（INIT / STATS）：从现有文档初始化或重建图谱，查看节点、边、记忆数量及按类型统计。触发语句如“Initialize knowledge graph”“Rebuild knowledge graph”“Show graph stats”。
  • 关系遍历：查询指定节点在指定深度内的相关内容。
  • TRIZ 矛盾记录：决策类记忆可附带矛盾（contradiction）、分离方式（separation：time/space/condition/level）和原理（principle）字段，并可按关键词过滤查询矛盾记录。
  • 维护工具：健康检查（health）、磁盘与图谱对账（reconcile）、衰减与陈旧检查（decay/stale）等。

使用方式

图谱默认位于 .agent/knowledge/graph.json。技能通过 Python 脚本执行，命令中先定位插件目录：

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/cache/navigator-marketplace/navigator}"
[ -d "$PLUGIN_DIR" ] || PLUGIN_DIR="$HOME/.claude/plugins/marketplaces/navigator-marketplace"

初始化/重建图谱：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_builder.py" \
  --agent-dir .agent \
  --output .agent/knowledge/graph.json

查询：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_manager.py" \
  --action query \
  --concept "testing" \
  --graph-path .agent/knowledge/graph.json

添加记忆：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_manager.py" \
  --action add-memory \
  --memory-type pitfall \
  --summary "auth changes often break session tests" \
  --concepts "auth,testing" \
  --confidence 0.9 \
  --graph-path .agent/knowledge/graph.json

统计与关系查询：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_manager.py" \
  --action stats \
  --graph-path .agent/knowledge/graph.json

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_manager.py" \
  --action related \
  --node-id "TASK-29" \
  --max-depth 2 \
  --graph-path .agent/knowledge/graph.json

记忆类型与置信度

记忆类型：pattern（可复用方法、项目约定）、pitfall（常见错误、陷阱）、decision（架构/技术选型与权衡）、learning（项目特定知识、错误解读）。

置信度：修正类捕获基础值 0.8，显式捕获 0.9；每周衰减 1%；每次使用 +5%（上限 +25%）；低于 0.3 视为可裁剪，高于 0.7 视为可靠。衰减与陈旧阈值仅由手动维护命令使用，不会在会话启动时自动应用。

与其他技能的集成

  • nav-start 在会话启动时加载图谱统计和相关记忆。
  • nav-task 在创建任务时自动抽取概念并加入图谱。
  • nav-profile 的修正可通过 correction_to_memory.py 转为记忆（convert-one / sync）。
  • nav-marker 在上下文中标记引用图谱状态。
  • navigator-research 输出的 research_findings JSON 可通过 research_to_graph.py 摄入，默认置信度 0.7；支持 --dry-run。
  • nav-deep-research 的网页研究结果经 report_to_graph.py --run <slug> 摄入，置信度与记忆类型相同。

写入与重建安全

v6.17.0+ 中，记忆的 .md 文件先于图谱节点写入，失败会显式报错；图谱保存失败会回滚文件。概念需通过图谱概念词表校验，未知概念会拒绝写入并列出有效词表，可用 --allow-new-concept 注册新概念。重建图谱会保留 memories 和 files 桶及其边；如需从零重建可传 --no-preserve-memories。

图谱维护

健康检查：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_maintenance.py" --action health

重复边、悬空边、置信度越界构成完整性门槛；v6.17.0 增加 Broken File Links 与 Unindexed Memory Files 两项计分检查，概念词表漂移和归档文件为建议项。

磁盘与图谱对账：

python3 "$PLUGIN_DIR/skills/nav-graph/functions/graph_maintenance.py" --action reconcile

--execute 会注册未索引文件并从磁盘复制 TRIZ 脚注字段到已索引节点，不会自动删除断链节点或重写概念引用。

配置

在 .agent/.nav-config.json 的 knowledge_graph 下可配置 enabled、auto_capture_corrections、auto_capture_decisions、auto_surface_relevant、max_session_memories、confidence_decay_rate、staleness_threshold_days、git_tracked 等项。

适用场景与限制

适用于在 Claude 等环境中使用 Navigator 插件进行项目开发时，沉淀经验教训、查询历史决策与陷阱、维护项目知识一致性。限制与未提供信息：具体收费、价格、支持平台与效果数据暂未提供；功能行为以技能资料为准，未在资料中描述的能力不作保证。