Browse / Professional & finance / LLM wiki / ontology-evo
ontology-evo
indie-builder
A Claude Code workspace agent for evidence-grounded sales analysis with EvoOntology, synthetic data, and reproducible task verification.
Open indie-builder/ontology-evo → Checked against the four rules.
Built for Claude Code
ships .claude CLAUDE.md and nothing for other agents.
In its own words
一个目录就是一个以 Claude Code 为底座的智能体。进入这个目录后,直接用自然语言提问,主会话按需查询业务本体、执行只读数据分析,并记录可追溯的真实任务。
本项目参考并集成 ruc-datalab/EvoOntology。知识构建、语义导航、任务轨迹与本体进化沿用其官方方法。本项目增加销售业务场景、DuckDB查询工具、合成数据和回归验证,不是EvoOntology官方销售模板,也不修改其核心实现。
先了解这个项目
本项目解决三个问题:让每个Workspace拥有稳定的智能体行为,让Agent复用有证据的业务知识,让每次分析可执行、可追溯。Claude Code是运行底座,EvoOntology是业务语义与版本层,DuckDB是当前本地查询引擎。
运行时没有额外自建的模型循环,也没有把整个本体和全量数据一次塞入提示词。主会话按问题加载技能、按需取语义、调用真实查询工具,再保存结果。网页只用于查看,不是智能体入口;代码没有训练模型权重。
与官方项目的关系
EvoOntology维护业务语义,数据引擎提供查询,Claude Code负责根据问题探索与分析。
- 从workload与数据证据构建知识,不把表结构机械转换成术语。
- 保持Term、Mapping、Relation、Constraint、Evidence五类记录,不另造指标DSL或语义规划器。
- 本体保存业务含义及证据,SQL和本次任务答案留在执行轨迹。
- 语义结果用于定位和约束,最终数字来自真实数据查询。
- Build、Explore、Evolve使用官方技能与MCP发布生命周期;进化提醒不自动触发更新。
- Candidate与Parent按官方数据边界评估,公开构建回放不冒充独立验证。
- EvoOntology中文介绍
- 产品化使用指南
- 官方Build技能
- 语义结构与交互协议
- 官方Evolve技能
本机验证使用EvoOntology插件1.1.1。设计依据核对仓库提交 c94389b764394379086ff25e50d0e0f4396167b4;固定版本的来源链接和职责对应见智能体定义。
快速开始
需要Claude Code、Python3.10以上和uv。查询工具固定使用DuckDB1.5.6与MCP SDK2.3.0,由uv隔离加载;首次启动需下载依赖。本地实测使用Python3.14。
首次接受工作目录和 workspace-analytics 项目MCP配置。在Claude Code中运行:
该技能生成百万订单DuckDB与Parquet,检查样例后通过官方MCP将配套本体发布到 .evoontology/analytics。它是已知样例导入,不宣称自主发现;已有版本不覆盖,不复制作者会话或轨迹。全新克隆的完整setup技能仍需按宿主权限完成,数据生成、官方发布和初始化后的真实分析已分别实测。
若希望观察从数据探索知识,使用官方 /evoontology:build-ontology,明确针对 config/analytics.json 的数据源、分析目标和 docs/analytics-policy.md 构建,而不导入样例本体。
也可以问客户地区、支付客单价或退款口径。请求不具备数据依据的品类退款分摊时,智能体应报告缺口,不猜分摊规则。无需打开网页或手工指定工具;可用 /sales-analysis 问题 显式选择流程。
Quoting 38% of the README. Read the rest on GitHub ↗
Read from the repository's git tree on 2026-08-17.