From bbe722a2a54063fed10adf10a85e295aefaf34e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E5=A2=A8?= <xiaomooo@shazhou.work>
Date: Sun, 12 Apr 2026 13:52:38 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20OGraph=20=E5=91=BD?=
 =?UTF-8?q?=E5=90=8D=E8=A7=84=E8=8C=83=EF=BC=88snake=5Fcase=20+=20?=
 =?UTF-8?q?=E8=BF=87=E5=8E=BB=E5=88=86=E8=AF=8D=E4=BA=8B=E4=BB=B6=E5=90=8D?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

#215

提交: 小墨 🖊️（KUMA Team）
---
 docs/shared/ograph-object-model.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/shared/ograph-object-model.md b/docs/shared/ograph-object-model.md
index a099138..2136a56 100644
--- a/docs/shared/ograph-object-model.md
+++ b/docs/shared/ograph-object-model.md
@@ -19,6 +19,23 @@ Reaction Layer (响应层)
 - **事实不可变，解读可进化** — 原始事件永不修改，Projection 可以升级
 - **名字是指针，hash 是锚点** — 名字在 API 入口解析，系统内部全用 content hash
 
+### 命名规范
+
+全部 **snake_case**，ASCII 小写，无空格无连字符。
+
+| 实体 | 模式 | 示例 |
+|---|---|---|
+| Object Def | `{noun}` | `task`, `agent`, `project` |
+| Event Def | `{object}_{past_participle}` | `task_created`, `task_assigned`, `task_commented` |
+| Projection Def | `{描述性名字}` | `comment_count`, `current_assignee`, `active_tasks` |
+| Property | `{noun}` | `task`, `assignee`, `author`, `status` |
+| Params | `${property}_id` | `$task_id`, `$agent_id`, `$project_id` |
+
+**说明：**
+- Event 用过去分词 — 事件是已经发生的事实（`task_assigned` 而非 `assign_task`）
+- Params 带 `_id` 后缀 — 区分属性名本身（`assignee` 是 property，`$assignee_id` 是 param）
+- Object Def 用单数名词 — `task` 不是 `tasks`
+
 ## Definition Layer（定义层）
 
 ### 2.1 Object Def