feat: add research collaboration architecture

This commit is contained in:
bingshuo 2026-07-12 15:16:00 +08:00
parent 2e93b58aab
commit cca3686516
8 changed files with 167 additions and 0 deletions

View File

@ -12,6 +12,19 @@
Tolaria 人类界面 → 工单 → AI 受控处理 → 回执写入仓库 → Tolaria 展示结果
```
## 研发语言路径
```text
光湖语言生态系统(主系统入口)
→ HoloLake Platform研发主仓
→ 光湖研发广播台(任务与模块事实源)
→ 人类研发频道(人类 + 当前协作 AI
→ 工单、回执与协作记录
→ 模块注册表与研发进度追踪
```
详细规则见 [`research/`](research/README.md) 与 [`architecture/`](architecture/README.md)。
## 仓库边界
- `standards/`:已确认的 GLS、TCS、HLDP 与产品标准。

31
architecture/README.md Normal file
View File

@ -0,0 +1,31 @@
# 光湖研发元系统架构
## 主路径
```text
光湖语言生态系统
→ HoloLake Platform
→ 光湖研发广播台
→ 人类研发频道
→ 工单 / 回执 / 协作记录
→ 模块注册表 / 进度追踪
→ Tolaria 或光湖 App 人类视图
```
## 角色与边界
| 对象 | 职责 | 不能做什么 |
| --- | --- | --- |
| 人类研发者 | 提出方向、确认范围、验收结果 | 不必操作代码或服务器 |
| 当前协作 AI | 检索、规划、实现、记录和汇报 | 不改变平台身份,不自行扩大权限 |
| 研发广播台 | 发布研发任务、维护模块登记与状态 | 不自动把广播变成服务器操作 |
| 巡检服务 | 对照模块、工单、回执和进度,报告不一致 | 不自行重分配任务或改写事实 |
## 研发记录的双层可读
每项协作记录同时包含:
- 人类语义:为什么做、当前判断、关系到什么项目;
- 工程结构:编号、模块、状态、责任、证据与下一步。
历史记录用于下一个协作者理解和接续;不构成身份覆盖或自动执行指令。

22
research/README.md Normal file
View 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 只记录和执行获授权范围内的任务。

View 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"
```
广播只表达研发协调信息。它不自动授予服务器、账户、部署或数据修改权限。

View 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
```

View File

@ -0,0 +1,11 @@
# 广播台巡检
未来的巡检服务每天检查以下对应关系:
```text
广播任务 ↔ 模块注册表 ↔ 人类研发频道 ↔ 工单 ↔ 回执 ↔ 进度视图
```
巡检输出异常报告,例如:重复认领、没有工单的认领、已完成但缺回执、回执与模块状态不一致。
巡检服务只报告和建议修复;任何重新认领、状态变更或现实执行都需要人类确认。

View 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"

View File

@ -0,0 +1,11 @@
# 研发进度追踪
本目录用于生成供人类查询的研发状态视图。
进度数据必须来自:
1. `module-registry.yml` 的模块状态;
2. 已登记的工单;
3. 对应的执行回执。
不能只根据对话、计划或主观判断把模块标记为完成。