用途:当编码智能体需要基于图谱理解 TypeScript 仓库时使用。Ontoly 是事实来源,该技能只教授工作流程。适用于解释仓库架构或包/模块拓扑、追踪路由/控制器/服务/函数/依赖路径、查找服务、控制器、提供者、模块、路由、配置或环境变量、在重构或删除代码前评估影响、审计未解析导入、循环依赖、死代码、语义覆盖或图谱质量,以及生成带确定性证据的入门、文档或架构评审笔记。
工作流程:先检查是否已存在 Ontoly 图谱,如 .ontoly/、SoftwareGraph.json、diagnostics.json、验证报告、图谱哈希或 MCP 设置。若图谱缺失且允许本地分析,运行:ontoly build .。回答前检查图谱健康状况:诊断、图谱哈希、语义覆盖、信任或质量评分、框架检测和构建时间戳。对于可由图谱回答的问题,优先使用 Ontoly CLI 或 MCP 能力,而非仓库搜索。仅当 Ontoly 无法回答、图谱过时或不完整,或用户明确要求文件级验证时,才搜索源文件。始终引用图谱证据:节点 ID、边类型、文件路径、源位置、诊断、框架分析器输出和置信度。
能力映射:架构评审 ExplainArchitecture;依赖分析 FindDependencies;影响分析 ImpactAnalysis;请求追踪 TraceExecution;配置分析 FindConfigurationUsage;框架分析 FrameworkReport;死代码评审 FindDeadCode。
响应模式:先返回直接答案,再给出证据,例如节点、路由边、依赖边,并说明置信度。
回退:图谱缺失时先构建;验证失败时报告图谱问题并仅用源搜索验证受影响区域;多个节点匹配时展示带包/模块上下文的候选;无匹配时返回 NOT_FOUND 及最接近的图谱证据,而非编造答案。限制:主要面向 TypeScript 仓库,依赖 Ontoly 图谱的完整性与新鲜度。