ontoly-software-graph
Use Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files when reviewing architecture, dependencies, request flows, configuration, impact, or security-sensitive ownership in JavaScript, TypeScript, Python, or Go repositories.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- ontoly-software-graph
- description
- Use Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files when reviewing architecture, dependencies, request flows, configuration, impact, or security-sensitive ownership in JavaScript, TypeScript, Python, or Go repositories.
03 SKILL.md 正文
Ontoly Software Graph
Use this skill when the user asks Codex to understand a JavaScript, TypeScript, Python, or Go repository's architecture, dependency graph, request flow, service ownership, configuration usage, impact radius, package topology, or security-sensitive code paths.
Ontoly is a deterministic Software Graph compiler. It does not answer questions with AI. It builds graph evidence that Codex can query before falling back to source search.
Workflow
-
Check whether a graph exists:
ontoly-output/SoftwareGraph.json(written byontoly build) or.ontoly/SoftwareGraph.json(written byontoly analyze). Queries read whichever is newer. -
If the graph is missing or stale, ask before installing dependencies or writing generated graph files. Then run:
pnpm add -D @0xsarwagya/ontoly-cli pnpm ontoly build . -
Inspect graph quality before answering:
pnpm ontoly coverage . pnpm ontoly stats . -
Prefer Ontoly graph queries before repository-wide source search:
pnpm ontoly evidence "<question>" pnpm ontoly search <concept> pnpm ontoly architecture --json pnpm ontoly impact <node-id-or-query> pnpm ontoly trace <node-id-or-name> pnpm ontoly report routes --format markdown -
Start Ontoly MCP when the environment supports MCP-backed tools:
pnpm ontoly mcp -
Use source files only when the graph is missing, stale, low confidence, or insufficient for the question.
Common Questions
- "Explain this repository."
- "Which service owns authentication?"
- "Trace the login flow."
- "What breaks if I remove this repository/service/function?"
- "Which packages depend on this module?"
- "Where is this environment variable read?"
- "Which routes are protected by auth?"
Evidence Rules
When answering, cite graph evidence:
- graph hash
- node ids
- relationship types
- source spans when available
- diagnostics or confidence warnings
- fallback reason if source files were inspected
Never claim certainty beyond Ontoly evidence. If graph coverage is incomplete, say exactly which part is inferred or unresolved.
Official Ontoly Skills
Ontoly publishes 14 task-specific Agent Skills in its own repository: architecture-review, codebase-onboarding, configuration-analysis, dead-code-analysis, dependency-analysis, documentation, framework-analysis, impact-analysis, migration-analysis, performance-analysis, refactoring, request-tracing, sdk-generation, and security-review. To inspect or install them with the open skills CLI:
npx skills add 0xsarwagya/ontoly --list
npx skills add 0xsarwagya/ontoly --skill impact-analysis
Use those official skills when the task maps directly to one of their workflows.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.