ontological-engineering-coach
Master Ontological Engineering & Knowledge Graph Modeling using Gruber criteria to balance precision vs coverage across domain ontologies. Do not use for unstructured document indexing or simple key-value storage.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ontological-engineering-coach
- description
- Master Ontological Engineering & Knowledge Graph Modeling using Gruber criteria to balance precision vs coverage across domain ontologies. Do not use for unstructured document indexing or simple key-value storage.
02 资源文件 2
- 参考文档CARD.md3.3 KB
- 参考文档config.default.yaml305 B
03 SKILL.md 正文
Ontological Engineering Coach
ontological-engineering-coach is an executable cognitive workflow engine derived from Ontological Engineering & Knowledge Graph Modeling presented by Prof. Dr. Harald Sack.
Every execution adheres to three foundational craft pillars:
- The Visual Brief — Interactive HTML reports generated in
%TEMP%rendering ontology schemas and competence DAGs. - The Mandatory Checkpoint — Explicit human-in-the-loop gates (
RequestFeedback: true) before modifying domain schemas. - Explicit Anti-Patterns — Rigid behavioral boundaries eliminating speculative over-commitment and taxonomy confusion.
See CARD.md for the summary card and completion checklist.
Execution Sequence
Stage 1: Competency Scoping & Boundary Definition
Formulate explicit natural-language competency questions defining the questions the knowledge model must answer.
- Interview domain experts and end-user personas to capture core tasks
- Formulate 5 to 15 concrete competency questions with expected query outputs
- Define strict out-of-scope boundaries to prevent domain creep
Completion criterion: Exhaustive list of verifiable competency questions agreed upon and documented.
Stage 2: Taxonomy & Class Hierarchy Construction
Draft the core subsumption hierarchy and relationship predicates satisfying audited competency queries.
- Extract primary domain entities into disjoint or subsumed classes
- Assign domain and range constraints to relational predicates
- Verify subclass relationships obey strict 'is-a' transitivity
Completion criterion: Directed Acyclic Graph (DAG) of class hierarchies verified free of cycles.
Stage 3: Gruber 5-Axis Quality Audit
Evaluate candidate schema against Clarity, Coherence, Extendibility, Minimal Bias, and Minimal Commitment.
- Run reasoner consistency check (HermiT or Pellet) to confirm formal coherence
- Audit class definitions for unambiguous, objective definitions (clarity)
- Verify representation independence (minimal encoding bias)
- Prune unused classes or axioms (minimal ontological commitment)
Completion criterion: Scored evaluation matrix with zero critical violations across all 5 criteria.
Stage 4: Competency Verification & Query Validation
Translate competency questions into SPARQL queries and verify expected result sets against sample instance graphs.
- Instantiate representative test instance data
- Author SPARQL test assertions mirroring original competency questions
- Validate query execution latency and result fidelity
Completion criterion: 100% of competency questions execute with non-empty, semantically correct answer sets.
Stage 5: Modularization & Lineage Documentation
Partition ontology into composable modules and author persistent documentation and CARD summary.
- Decompose monolithic ontologies into modular sub-domain schemas
- Add owl:versionInfo, rdfs:label, and rdfs:comment metadata
- Export schema diagram and register in knowledge graph catalog
Completion criterion: Versioned ontology artifact with metadata annotations and schema diagrams published.
Anti-Patterns
- Speculative Over-Commitment — Declaring exhaustive taxonomies and deeply nested hierarchies that have no immediate query requirements. Enforce Gruber's Minimal Commitment: model only what is strictly necessary to answer verified competency questions.
- Part-Whole Subclass Confusion — Declaring a component part as a subclass of the whole (e.g. Engine is-a Car instead of Engine part-of Car). Strictly verify that every instance of the child class is universally an instance of the parent class.
- Monolithic Coupling — Bundling disparate domain concepts into a single mega-schema that cannot be reused independently. Partition schemas into modular, single-responsibility sub-ontologies connected by explicit foreign keys.
04 同仓库更多 Skills
ui-behavior-primitive-architect
Architect, audit, and verify zero-dependency headless UI behavior primitives, WebMCP agent bridges, WAI-ARIA/SSR/RTL tri-modal checks, and framework expert routing. Do not use for static CSS theme styling or backend database migrations.
trustgraph-ontology-governor
Govern knowledge graphs, SHACL-AF triple policies, OntologyRAG subclass validation, PROV-O dual named graphs, and Laya entropy decision scoring. Do not use for relational SQL queries or generic web scraping.
shim-harness-governor
Govern universal CLI agent loops, 4-tier tool permissions, ancestor-symlink workspace sandboxes, deterministic-first command routing, collision-safe MCP namespacing, and layered skill loading. Do not use for static UI styling or external SQL analytics.
graphiti-zep-memory-governor
Govern bi-temporal knowledge graphs with Graphiti future-edge clamping, MinHash/LSH entity dedup, RRF/MMR reranking, and Zep typed ontologies. Do not use for static SQL joins or generic web crawling.
agora-mcp-workbench-architect
Architect, audit, and orchestrate Agora Workbench MCP servers, loopback sidecars, unified state graphs, gateway/dispatcher connectors, and policy-enforced data lakes. Do not use for static frontend CSS styling or non-MCP desktop GUI automation.
skill-eval-assurance-runner
Evaluate and assure agent skills using small-N Wilson confidence intervals, unbiased pass^k reliability, deterministic trajectory graders, preflight boundary honesty, and sealed digest verification. Do not use for subjective prose review or unconstrained production deployment.