用途：为使用 Omnigraph 图数据库（本地 RustFS 或远程 S3）提供操作规范，适用于编写 schema、查询、加载数据、演进 schema 及自动化图操作。
主要能力与规则：提交前用 omnigraph query lint --schema schema.pg --query queries/foo.gq 校验；apply 前必须先成功执行 schema plan；数据变更走特性分支，schema 变更直接进 main；写入命令按场景选择 change（编辑）、load --mode merge（本地批量 upsert）、ingest（远程）、load --mode overwrite（清空重写）；所有值参数化，声明 $var: Type 并通过 --params 传入；面向智能体的操作以别名暴露而非裸 CLI；远程写入后须用 commit list --branch main 对比前后 head 校验。
使用方式：本地可用 Docker 一键引导 RustFS 与 Omnigraph，默认 RustFS S3 在 127.0.0.1:9000、控制台 :9001、omnigraph-server :8080、bucket omnigraph-local，可用 BUCKET、PREFIX、BIND 覆盖。需在 .env.omni 配置 AWS 凭据并 source 后运行 CLI。命令须在含 omnigraph.yaml 的目录执行，配置字段为 graphs: 与 cli.graph/server.graph。
适用场景：本地或远程图数据库的 schema 管理、查询编写、数据加载与运维自动化。
限制：load 仅支持本地仓库 URI，远程须用 ingest；init 不支持 --json；.pg 注释用 //；枚举需内联；列表只能含标量；nearest/bm25/rrf 必须带 limit；新增非空属性需先可选再回填；远程 504 后不可盲目重试，须先查 commit list。更多细节见 references/ 下各参考文件。