Agent Skills
› davepoon/buildwithclaude
› ontoly-software-graph
ontoly-software-graph
GitHub指导代理使用Ontoly构建的软件图进行代码库架构分析、请求追踪、依赖影响评估及死代码审查，优先基于图数据而非直接搜索源码。
触发场景
需要理解代码库整体架构或模块归属
追踪特定请求或函数的调用链
评估重构或删除代码的影响范围
检查循环依赖或配置使用情况
安装
npx skills add davepoon/buildwithclaude --skill ontoly-software-graph -g -y
SKILL.md
Frontmatter
{
"name": "ontoly-software-graph",
"license": "MIT",
"category": "development-code",
"description": "Use Ontoly's deterministic Software Graph and MCP server for codebase architecture, request tracing, dependency analysis, and impact analysis."
}
Ontoly Software Graph
Use Ontoly when a coding agent needs graph-backed software understanding before searching source files directly.
Ontoly builds a deterministic Software Graph from a TypeScript repository and exposes it through CLI queries, MCP capabilities, and agent skills. The skill teaches workflow only; Ontoly remains the source of truth.
Workflow
- Check whether an Ontoly graph already exists in the repository, such as
.ontoly/,SoftwareGraph.json, or documented Ontoly scripts. - If the graph is missing and local graph output is appropriate, run
ontoly build .. - Check graph diagnostics, trust, semantic coverage, framework detection, and validation before making architecture claims.
- Prefer Ontoly CLI or MCP capabilities for architecture summaries, request tracing, dependency analysis, configuration lookup, framework reports, and impact analysis.
- Inspect source files only when the graph is missing, incomplete, untrusted for the question, or the user explicitly asks for source-level verification.
Use Cases
- Explain repository architecture, module ownership, services, routes, packages, or dependencies.
- Trace a request, route, controller, service, provider, dependency, or call chain.
- Estimate impact for removing, renaming, or refactoring a symbol, module, package, route, or service.
- Review circular imports, dead code, configuration usage, environment variables, or graph diagnostics.
Evidence Rules
- Separate graph facts from inference.
- Cite exact graph nodes, edges, packages, routes, diagnostics, or query outputs when available.
- Treat unresolved imports, low trust, missing framework detection, and validation failures as answer limitations.
- Do not claim a relationship exists unless Ontoly reports it or the answer labels it as inferred.
Example Prompts
Use Ontoly to explain this repository's architecture.
Use Ontoly to trace the login flow from route to controller, service, and repository.
Use Ontoly to find what depends on UserRepository and what breaks if it changes.
版本历史
- b79ed72 当前 2026-07-19 18:36
