SuperAPI AI 工具集

ontoly-software-graph

智能体与模型

查看项目

更新于 10-15 19:56

技能介绍

用途:当编码智能体需要基于 Ontoly 图谱获得有证据支撑的软件理解时使用本技能,适用于解释仓库架构、追踪请求/路由/控制器/服务/依赖路径、查找服务与模块及配置和环境变量的归属、重构前评估依赖影响、审计死代码与循环依赖及未解析导入、评估图谱质量与语义覆盖率,以及基于图谱证据编写文档、入职说明或架构评审。

必要工作流:先检查是否已存在 Ontoly 图谱,可查看 .ontoly/、SoftwareGraph.json、diagnostics.json、验证报告或 Ontoly MCP 配置。若不存在且用户允许本地分析,运行:ontoly build .。回答前先检查图谱健康状况,包括诊断信息、图谱哈希、语义覆盖率、信任或质量评分、框架检测与生成时间戳。图谱问题优先使用 Ontoly CLI 或 MCP 能力,而非先扫描源文件;仅当 Ontoly 无法回答、图谱过期或不完整、或用户明确要求源码级验证时才使用仓库搜索。回答中始终引用图谱证据,如节点 ID、边类型、文件路径、源码位置、诊断或框架分析器输出,并依据图谱证据说明置信度,不得猜测。

主要能力:ExplainArchitecture 用于仓库与包拓扑;FindDependencies 用于依赖树与直接消费者;ImpactAnalysis 用于重构影响范围;TraceExecution 用于请求、路由与调用流追踪;FindConfigurationUsage 用于配置与环境变量使用;FrameworkReport 用于检测模块、控制器、提供者、路由等框架概念;FindDeadCode 用于查找不可达或未使用的图谱区域。

回答结构:包含直接答案、图谱证据、置信度、诊断或注意事项,必要时才回退到源码检查。回退规则:图谱缺失时在允许下先构建;验证失败时报告失败并仅用源码搜索核实受影响区域;同名多节点时请求消歧或展示带包/模块上下文的候选;概念不在图谱中时返回 NOT_FOUND 并给出最接近的图谱证据,不得编造答案。其他收费、平台与效果信息暂未提供。