diff --git a/docs/todo/system-design/27-naming-conventions.md b/docs/todo/system-design/27-naming-conventions.md index bfce6ae..b07de68 100644 --- a/docs/todo/system-design/27-naming-conventions.md +++ b/docs/todo/system-design/27-naming-conventions.md @@ -25,7 +25,7 @@ | `{domain}` | 业务领域(`code` / `content` / `ops` …),即 org node 所属领域 | | `company-goal` | **公司的目标**(建公司时写入,OKR 树的输入)| | `task-goal` | **一次用户请求的目标**(唯一,验收边界;R-12 说的就是这一层)| -| `subagent-goal` | **子任务的目标**(一个 task-goal 分解出多个)| +| `subtask-goal` | **子任务的目标**(一个 task-goal 分解出多个)| | `task` | 图中的执行单元(一个 task-goal 分解出多个,可并行)| | `agent` | 单个 system agent | | `skill` | 单个 skill | @@ -91,13 +91,13 @@ work graph 内动态选入的验收产出节点(见 [27-E2E](./27-e2e-task-exe |---|---|---|---| | **`company-goal`** | 公司 | OKR 树(长周期度量) | `company.json.goal`,建公司时写入 | | **`task-goal`** | 一次用户请求 | org graph 末端的 `{domain}-validator` | 任务入口带入 | -| **`subagent-goal`** | 子任务 / 并行分支 | 该 work graph 内的 validator 节点 | 由 `workgraph-planning` 拆分时产生 | +| **`subtask-goal`** | 子任务 / 并行分支 | 该 work graph 内的 validator 节点 | 由 `workgraph-planning` 拆分时产生 | **`company-goal` 与 OKR 的关系**:`company-goal` 是建公司时的一句话**定性**目标,是 **OKR 树的输入**——OKR 把它拆成可度量的 Objective → Key Result。两者不是替代关系,不要用 OKR 节点去存 `company-goal`。 -**三个验收 agent(`goal-benchmark` / `goal-test-data` / `goal-test-script`)是通用的,不按层级拆分**:它们在哪一层被调用,就为那一层的 goal 产出验收标准。这与 §八bis 的元 agent 继承(全局通用本体 + 记忆分区)一致——不需要 `task-goal-benchmark` / `subagent-goal-benchmark` 这种按层级复制的 agent。 +**三个验收 agent(`goal-benchmark` / `goal-test-data` / `goal-test-script`)是通用的,不按层级拆分**:它们在哪一层被调用,就为那一层的 goal 产出验收标准。这与 §八bis 的元 agent 继承(全局通用本体 + 记忆分区)一致——不需要 `task-goal-benchmark` / `subtask-goal-benchmark` 这种按层级复制的 agent。 -> **一处命名轴不一致(待定,不阻塞)**:`company-goal` / `task-goal` 是按**作用域**命名,`subagent-goal` 是按**执行者**命名。按作用域应为 `subtask-goal`。当前按提出时的原词 `subagent-goal` 记录,若要统一改为 `subtask-goal`,全局换一个词即可。 +> **命名轴已统一**(R-14):三者一律按**作用域**命名 —— `company-goal` / `task-goal` / `subtask-goal`。最初提出时第三个叫 `subagent-goal`(按**执行者**命名,与另两个的轴不一致),已统一为 `subtask-goal`。原话见 [27-REQ](./27-requirement.md) R-13.1。 > **决策沿革**(完整过程见 [27-REQ](./27-requirement.md) R-10 / R-12):最初选 `task-`,理由是"`goal` 被 OKR 占用";§六 把 OKR 正名后该理由失效,改用"验收跟着一次 task 执行走"继续保留 `task-`;最终因上面的基数论证推翻,定为 `goal-`。 diff --git a/docs/todo/system-design/27-requirement.md b/docs/todo/system-design/27-requirement.md index 50d7243..15d0d31 100644 --- a/docs/todo/system-design/27-requirement.md +++ b/docs/todo/system-design/27-requirement.md @@ -182,7 +182,7 @@ **澄清了什么**:R-12 说的「一个人类需求描述只有一个 goal」,指的其实是三层里的 **`task-goal`**。三个验收 agent(`goal-benchmark` / `goal-test-data` / `goal-test-script`)保持通用,不按层级拆分——在哪一层调用就为那一层的 goal 产出标准,与 R-9.2 元 agent 继承一致。 -**待定(不阻塞)**:`subagent-goal` 是按执行者命名,另两个按作用域命名,轴不一致;按作用域应为 `subtask-goal`。当前按原词记录。 +**后续变更(R-14)**:`subagent-goal` 按执行者命名,与另两个的作用域命名轴不一致,**已定名为 `subtask-goal`**。上方原话保留提出时的用词,不随之改写。 ### R-13.2 · 公司类型由 agent 推断 @@ -208,6 +208,16 @@ --- +## R-14 · 命名轴统一为作用域 + +> 改成 subtask-goal + +**落点**:[27-NAMING](./27-naming-conventions.md) §四 + +**定案**:三层 goal 一律按**作用域**命名 —— `company-goal` / `task-goal` / `subtask-goal`。R-13.1 提出时第三个叫 `subagent-goal`(按**执行者**命名,与另两个的轴不一致),本条统一。R-13.1 的原话引用保留提出时的用词,不随之改写。 + +--- + ## 附 · 需求 → 设计落点 速查 | 需求 | 一句话 | 主要落点 | @@ -224,4 +234,5 @@ | R-10 | 统一命名前缀 | NAMING 全文 | | R-11 | OKR 正名,不叫 goal | NAMING §六 | | R-12 | **验收产物定名 `goal-`**;goal 唯一、task 多个 | NAMING §四 | -| R-13 | goal 三层(company/task/subagent);类型由 agent 推断;新 agent 从 base 继承;强制单入口 | NAMING §四 / P2 §3.3 §4.1 §五 | +| R-13 | goal 三层;类型由 agent 推断;新 agent 从 base 继承;强制单入口 | NAMING §四 / P2 §3.3 §4.1 §五 | +| R-14 | 命名轴统一为作用域:`subagent-goal` → **`subtask-goal`** | NAMING §四 |