Avouch Studio
ZH
打开 Studio

面向软件与 AI AGENT 的共享语义层

让整个系统拥有同一份共识。

软件的知识分散在代码、文档和历史决策中。Avouch 将这些知识组织成统一、可溯源的结构化系统模型,让开发者直观理解,让 Agent 精确查询,让团队有依据地持续演进。

AVOUCH SPEC / AI SKILL + COMMAND / CLI / STUDIO

Avouch Studio · 订单生命周期3 种对象类型
示例模型 · orders.ontology.yaml
直接查询模型,无须翻遍文档avouch CLI

$ avouch query writes Order.status -f orders.ontology.yaml

target: Order.status
writers:
  - action: CONFIRM_DELIVERY
  - action: PAY_ORDER
  - action: SHIP_ORDER

哪些操作会写 Order.status · 只读查询 · 对应有版本记录的模型

要解决的问题

让系统知识摆脱碎片化。

规格文档不断增加,代码持续变化,Agent 只能看到不完整的上下文。Avouch 让团队共同使用一份能明确表达关键业务规则和关系的系统模型。

01 / 统一模型

业务语义有统一归属

对象、关系、规则、权限和状态迁移都收敛到一份机器可读的模型,减少业务含义散落在各处所造成的分歧。

02 / 面向 Agent

为 Agent 提供可靠上下文

Agent 可以精确查询操作的效果、字段的依赖以及规则的来源,无需在可能相互矛盾的文档中反复搜索。

03 / 可控变更

理解每一次变更的影响

将声明连接到原文证据,显式记录尚未明确的问题,并在修改前识别读写依赖,为可控演进建立基础。

AVOUCH 生态

从已有项目建立持续演进的系统模型。

围绕一份共享 Avouch Spec 构建的完整工作流。

01 / AI SKILL

发现

通过 AI Skill 和命令扫描项目文档与代码,生成候选模型,并标记需要人工处理的冲突。

/avouch:scan

02 / SPEC

建模

使用可移植的 Avouch Spec 描述领域对象、业务操作、状态迁移、权限及来源证据。

*.ontology.yaml

03 / CLI

查询

Agent 可以通过 CLI 查询字段读写依赖、操作定义、规则引用和来源锚点,获得结构化答案。

avouch query · avouch check

04 / STUDIO

演进

现在即可可视化探索模型,未来将通过编辑、语义 Diff、影响分析和变更管理形成闭环。

查看 → 编辑 → 对比 → 管理

目前已具备项目扫描 Skill、只读 CLI 和可视化查看器。扫描得到的是需要审查的候选模型;编辑器、语义 Diff 和变更管理是 Studio 的演进方向。

AVOUCH STUDIO

理解复杂系统,管理持续变化。

Studio 将逐步把模型编辑、版本差异和影响管理整合到同一个可视化工作空间中。现在可以从浏览真实模型开始。

打开 Studio ↗
模型可视化现已可用

在浏览器中查看领域对象、关系、操作、状态机、来源引文和 Schema 检查结果。

模型编辑器路线图

在规范不断完善的过程中,围绕模型和来源证据进行编辑与验证。

语义 Diff 与变更管理路线图

比较模型版本中的语义变化,识别受影响的操作与依赖,在变更扩散前完成审查。

开放、可移植,并兼容已有生态。

Avouch Spec 是可移植的语义契约。Avouch Studio 也支持读取 OWL 和 RDF,让现有本体与系统行为模型协同工作。

Avouch SpecOWL 2RDFSTurtleJSON-LDRDF/XML

体验 AVOUCH STUDIO

查看自己的本体模型

精选示例

六个示例,六种理解系统的方式。

通过精简的场景,了解 Avouch 如何表达业务决策、依赖及未知项。所有示例均为模拟数据。

网上订单

Avouch · YAML

查看订单生命周期,以及每次状态变化由哪个操作执行。

  1. 1打开“Order 状态”。 每个箭头都标出执行它的命令。
  2. 2点击 DELIVERED → RETURNED。 没有命令执行它;文件写明了原因。
  3. 3打开“命令 × 对象”。 PAY_ORDER 创建 Payment;SHIP_ORDER 只读取它。

保险理赔

Avouch · YAML

查看包含不同权限、审批阈值及跨上下文影响的决策过程。

  1. 1查看 Claim 状态。 CLOSED → REOPENED 是一条回边:由 REOPEN_CLAIM 执行,之后 ASSIGN_ADJUSTER 把理赔送回 UNDER_ASSESSMENT。
  2. 2点击 APPROVE_CLAIM。 权限是 any_of:理算员、理赔经理或总监的权限键;决策表逐级检查审批额度,都不满足时结果为 REFERRED。
  3. 3打开“命令 × 对象”,点击 REFER_TO_SIU。 它在特别调查上下文中创建 FraudReview,并在同一操作中把 Claim 置为 ON_HOLD。

订阅计费

Avouch · YAML

追踪订阅与支付流程中的跨领域关系、条件和决策路径。

  1. 1依次点击 CHARGE_INVOICE、PAUSE_SUBSCRIPTION、CANCEL_SUBSCRIPTION。 幂等键分别为:必须、不要求、未声明。每个已声明的值都引用了来源。
  2. 2点击 RETRY_PAYMENT。 催缴决策表:第一个未通过的检查决定结果;全部通过则安排重试,下一步执行 CHARGE_INVOICE。
  3. 3打开“命令 × 对象”。 写 Invoice 的命令来自三个上下文;RECORD_PAYMENT_RESULT 同时写 PaymentAttempt、Invoice 和 Subscription。

退款政策:文档没写清的地方

Avouch · YAML

查看相互冲突的政策和缺失的要求如何作为来源缺口保持可见。

  1. 1点击 REVIEW_REQUEST。 退款期限标为 unspecified:政策页写 30 天,FAQ 写 14 天,文件保留了两条引文。
  2. 2点击 GRANT_EXCEPTION。 权限是 unknown:政策没有指明哪个角色,文件也不替它编一个。
  3. 3阅读总览(不选中任何内容)。 四条已知来源缺口,类型各不相同,每条都写明缺什么以及建议的修正。

一个有错误的文件

Avouch · YAML

查看无效规格如何在 Schema 校验时被发现并解释。

  1. 1看 schema 标记。 schema 校验失败,并统计错误数:schema ✗ 4。
  2. 2点击一条错误。 它显示路径和 schema 的要求,并打开对应条目。
  3. 3把鼠标悬停在字段旁的 ? 上。 它显示 schema 中该字段的说明。

Orchard

OWL · Turtle

打开 OWL 本体,了解 Studio 如何兼容成熟的语义 Web 格式。

  1. 1点击 FruitTree。 它的限制显示为文字:bears some Fruit、planted in only Plot。
  2. 2点击 Gardener。 基数显示为文字:tends min 1 Tree、tends max 5。
  3. 3点击 Plant。 其他语言的标签保留语言标记:"Plante"@fr。

AVOUCH SPEC

实验性规格 · 持续快速演进

让人、代码与 Agent 共享语义契约。

Avouch Spec 为人类、Agent 和工具提供统一的表达语言。可以查看 Schema、来源引用机制和 Agent 编写指南,也可以直接在 Studio 中打开模型。