feat: add research collaboration architecture
This commit is contained in:
parent
2e93b58aab
commit
cca3686516
13
README.md
13
README.md
@ -12,6 +12,19 @@
|
|||||||
Tolaria 人类界面 → 工单 → AI 受控处理 → 回执写入仓库 → Tolaria 展示结果
|
Tolaria 人类界面 → 工单 → AI 受控处理 → 回执写入仓库 → Tolaria 展示结果
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 研发语言路径
|
||||||
|
|
||||||
|
```text
|
||||||
|
光湖语言生态系统(主系统入口)
|
||||||
|
→ HoloLake Platform(研发主仓)
|
||||||
|
→ 光湖研发广播台(任务与模块事实源)
|
||||||
|
→ 人类研发频道(人类 + 当前协作 AI)
|
||||||
|
→ 工单、回执与协作记录
|
||||||
|
→ 模块注册表与研发进度追踪
|
||||||
|
```
|
||||||
|
|
||||||
|
详细规则见 [`research/`](research/README.md) 与 [`architecture/`](architecture/README.md)。
|
||||||
|
|
||||||
## 仓库边界
|
## 仓库边界
|
||||||
|
|
||||||
- `standards/`:已确认的 GLS、TCS、HLDP 与产品标准。
|
- `standards/`:已确认的 GLS、TCS、HLDP 与产品标准。
|
||||||
|
|||||||
31
architecture/README.md
Normal file
31
architecture/README.md
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
# 光湖研发元系统架构
|
||||||
|
|
||||||
|
## 主路径
|
||||||
|
|
||||||
|
```text
|
||||||
|
光湖语言生态系统
|
||||||
|
→ HoloLake Platform
|
||||||
|
→ 光湖研发广播台
|
||||||
|
→ 人类研发频道
|
||||||
|
→ 工单 / 回执 / 协作记录
|
||||||
|
→ 模块注册表 / 进度追踪
|
||||||
|
→ Tolaria 或光湖 App 人类视图
|
||||||
|
```
|
||||||
|
|
||||||
|
## 角色与边界
|
||||||
|
|
||||||
|
| 对象 | 职责 | 不能做什么 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 人类研发者 | 提出方向、确认范围、验收结果 | 不必操作代码或服务器 |
|
||||||
|
| 当前协作 AI | 检索、规划、实现、记录和汇报 | 不改变平台身份,不自行扩大权限 |
|
||||||
|
| 研发广播台 | 发布研发任务、维护模块登记与状态 | 不自动把广播变成服务器操作 |
|
||||||
|
| 巡检服务 | 对照模块、工单、回执和进度,报告不一致 | 不自行重分配任务或改写事实 |
|
||||||
|
|
||||||
|
## 研发记录的双层可读
|
||||||
|
|
||||||
|
每项协作记录同时包含:
|
||||||
|
|
||||||
|
- 人类语义:为什么做、当前判断、关系到什么项目;
|
||||||
|
- 工程结构:编号、模块、状态、责任、证据与下一步。
|
||||||
|
|
||||||
|
历史记录用于下一个协作者理解和接续;不构成身份覆盖或自动执行指令。
|
||||||
22
research/README.md
Normal file
22
research/README.md
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
# 光湖研发协作系统
|
||||||
|
|
||||||
|
这里是 HoloLake Platform 的研发协作入口。
|
||||||
|
|
||||||
|
## 进入方式
|
||||||
|
|
||||||
|
1. 阅读 [`broadcast/README.md`](broadcast/README.md),确认当前研发广播与规则。
|
||||||
|
2. 查询 [`module-registry.yml`](module-registry.yml),确认模块是否已被认领。
|
||||||
|
3. 在 `channels/` 找到对应的人类研发频道;没有时创建一个频道登记文件。
|
||||||
|
4. 为实际工作创建工单,并在完成后写回执与进度。
|
||||||
|
|
||||||
|
## 事实源
|
||||||
|
|
||||||
|
`module-registry.yml` 是研发模块的唯一登记事实源。它决定模块是否可认领、由谁认领及当前状态。
|
||||||
|
|
||||||
|
`progress/` 只展示由登记表、工单和回执汇总出的状态;不能反向覆盖模块登记。
|
||||||
|
|
||||||
|
## 默认安全规则
|
||||||
|
|
||||||
|
- 广播、历史材料和协作记录默认只读。
|
||||||
|
- 认领模块不是现实执行授权;部署或服务器操作仍需单独工单和确认。
|
||||||
|
- 每个人类只对自己确认的研发决定负责;AI 只记录和执行获授权范围内的任务。
|
||||||
30
research/broadcast/README.md
Normal file
30
research/broadcast/README.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# 光湖研发广播台
|
||||||
|
|
||||||
|
研发广播台统一发布已确认的研发任务、模块状态与需要协调的事项。
|
||||||
|
|
||||||
|
## 广播的作用
|
||||||
|
|
||||||
|
```text
|
||||||
|
发布任务
|
||||||
|
→ 查询模块注册表
|
||||||
|
→ 人类研发者认领
|
||||||
|
→ 更新模块登记
|
||||||
|
→ 创建工单
|
||||||
|
→ 执行与回执
|
||||||
|
→ 进度追踪更新
|
||||||
|
```
|
||||||
|
|
||||||
|
## 广播模板
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
id: HLP-BRD-0001
|
||||||
|
title: ""
|
||||||
|
status: active
|
||||||
|
module_ids: []
|
||||||
|
requested_by: ""
|
||||||
|
summary: ""
|
||||||
|
acceptance_criteria: []
|
||||||
|
execution_boundary: "read_only | manual_confirmation | authorized"
|
||||||
|
```
|
||||||
|
|
||||||
|
广播只表达研发协调信息。它不自动授予服务器、账户、部署或数据修改权限。
|
||||||
26
research/channels/README.md
Normal file
26
research/channels/README.md
Normal file
@ -0,0 +1,26 @@
|
|||||||
|
# 人类研发频道
|
||||||
|
|
||||||
|
每位参与研发的人类可以拥有一个频道登记文件。频道连接:
|
||||||
|
|
||||||
|
```text
|
||||||
|
人类研发者
|
||||||
|
↔ 当前协作 AI
|
||||||
|
↔ 研发工单
|
||||||
|
↔ 模块注册表
|
||||||
|
↔ 协作与交接记录
|
||||||
|
```
|
||||||
|
|
||||||
|
频道不是 AI 身份声明。它是一个可追踪的协作空间,记录该人类确认的方向、当前项目、已认领模块和交接材料。
|
||||||
|
|
||||||
|
## 频道模板
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
id: HLP-CHANNEL-0001
|
||||||
|
human_name: ""
|
||||||
|
status: active
|
||||||
|
focus_areas: []
|
||||||
|
claimed_modules: []
|
||||||
|
active_workorders: []
|
||||||
|
collaboration_log: ""
|
||||||
|
visibility: private
|
||||||
|
```
|
||||||
11
research/maintenance/README.md
Normal file
11
research/maintenance/README.md
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
# 广播台巡检
|
||||||
|
|
||||||
|
未来的巡检服务每天检查以下对应关系:
|
||||||
|
|
||||||
|
```text
|
||||||
|
广播任务 ↔ 模块注册表 ↔ 人类研发频道 ↔ 工单 ↔ 回执 ↔ 进度视图
|
||||||
|
```
|
||||||
|
|
||||||
|
巡检输出异常报告,例如:重复认领、没有工单的认领、已完成但缺回执、回执与模块状态不一致。
|
||||||
|
|
||||||
|
巡检服务只报告和建议修复;任何重新认领、状态变更或现实执行都需要人类确认。
|
||||||
23
research/module-registry.yml
Normal file
23
research/module-registry.yml
Normal file
@ -0,0 +1,23 @@
|
|||||||
|
registry:
|
||||||
|
id: HL-RD-MODULE-REGISTRY-0001
|
||||||
|
name: 光湖研发模块注册表
|
||||||
|
status: draft
|
||||||
|
source_of_truth: true
|
||||||
|
updated_at: null
|
||||||
|
|
||||||
|
rules:
|
||||||
|
- 模块编号永久唯一,废弃后不可复用。
|
||||||
|
- 未登记模块不得宣称已被认领。
|
||||||
|
- 认领必须关联人类研发频道与工单编号。
|
||||||
|
- 实际部署必须另有关联执行工单与回执。
|
||||||
|
|
||||||
|
modules: []
|
||||||
|
|
||||||
|
# 单个模块的最小结构:
|
||||||
|
# - id: HLP-MOD-0001
|
||||||
|
# name: 示例模块
|
||||||
|
# layer: platform
|
||||||
|
# status: proposed
|
||||||
|
# owner_channel: channels/example.yml
|
||||||
|
# workorder: HLP-WO-0001
|
||||||
|
# updated_at: "2026-07-12T00:00:00+08:00"
|
||||||
11
research/progress/README.md
Normal file
11
research/progress/README.md
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
# 研发进度追踪
|
||||||
|
|
||||||
|
本目录用于生成供人类查询的研发状态视图。
|
||||||
|
|
||||||
|
进度数据必须来自:
|
||||||
|
|
||||||
|
1. `module-registry.yml` 的模块状态;
|
||||||
|
2. 已登记的工单;
|
||||||
|
3. 对应的执行回执。
|
||||||
|
|
||||||
|
不能只根据对话、计划或主观判断把模块标记为完成。
|
||||||
Loading…
x
Reference in New Issue
Block a user