用途：该技能是 Ontoly 公开项目的操作指南，用于让编码智能体在搜索文件前先获得有证据支撑的代码库理解。适用于仓库架构、模块归属、上手帮助、请求/路由/控制器/服务/调用链追踪、符号或模块删除重命名重构的影响评估，以及依赖拓扑、循环导入、死代码、配置与环境变量审查。
主要能力：Ontoly 从 TypeScript 仓库构建确定性软件图，并通过 CLI 查询、MCP 能力与智能体技能暴露，包括架构摘要、依赖分析、请求追踪、影响分析、配置查找、框架报告、死代码分析与图验证。技能本身不含编译器逻辑，理解均来自生成的图、语义模型、查询引擎与 MCP 服务器。
使用方式：先确认仓库是否已有 .ontoly/、SoftwareGraph.json、验证报告或文档化脚本，可用 ontoly --help 与 find . -maxdepth 3 ( -name "SoftwareGraph.json" -o -name ".ontoly" ) -print 检查；仅在用户指定仓库运行 ontoly build .，若项目有文档化命令则优先使用；回答前检查诊断、图统计、信任度与语义覆盖；支持 MCP 时用 ontoly mcp 启动或连接。回答需包含所用能力或查询、节点/边/路由/包/诊断证据、基于图证据的置信度及已知限制。仅在 Ontoly 无法回答、图缺失或不可信、用户要求源码级验证时回退到直接查看文件，并说明图证据不足之处。
限制：Ontoly 不替代编译器、测试或运行时验证；图质量取决于版本、支持的语言前端、仓库设置与诊断；框架检测缺失会降低相关回答置信度；未出现在图中的关系不得声称存在，除非明确标注为推断；仓库路径、目标图或分析范围不明确时应停止并请求澄清。安全上仅分析获授权仓库，未经用户明确要求不得将图文件、源码、环境变量、诊断或仓库元数据发送到外部服务，环境变量与配置节点可能敏感，图生成会在仓库内创建输出、诊断、索引或缓存文件，未经文档化或用户批准不得执行项目构建脚本、安装或网络命令。