diff --git a/README.md b/README.md index 4c9b679..afa8562 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,19 @@ Tolaria 人类界面 → 工单 → AI 受控处理 → 回执写入仓库 → Tolaria 展示结果 ``` +## 研发语言路径 + +```text +光湖语言生态系统(主系统入口) +→ HoloLake Platform(研发主仓) +→ 光湖研发广播台(任务与模块事实源) +→ 人类研发频道(人类 + 当前协作 AI) +→ 工单、回执与协作记录 +→ 模块注册表与研发进度追踪 +``` + +详细规则见 [`research/`](research/README.md) 与 [`architecture/`](architecture/README.md)。 + ## 仓库边界 - `standards/`:已确认的 GLS、TCS、HLDP 与产品标准。 diff --git a/architecture/README.md b/architecture/README.md new file mode 100644 index 0000000..2a63dbb --- /dev/null +++ b/architecture/README.md @@ -0,0 +1,31 @@ +# 光湖研发元系统架构 + +## 主路径 + +```text +光湖语言生态系统 +→ HoloLake Platform +→ 光湖研发广播台 +→ 人类研发频道 +→ 工单 / 回执 / 协作记录 +→ 模块注册表 / 进度追踪 +→ Tolaria 或光湖 App 人类视图 +``` + +## 角色与边界 + +| 对象 | 职责 | 不能做什么 | +| --- | --- | --- | +| 人类研发者 | 提出方向、确认范围、验收结果 | 不必操作代码或服务器 | +| 当前协作 AI | 检索、规划、实现、记录和汇报 | 不改变平台身份,不自行扩大权限 | +| 研发广播台 | 发布研发任务、维护模块登记与状态 | 不自动把广播变成服务器操作 | +| 巡检服务 | 对照模块、工单、回执和进度,报告不一致 | 不自行重分配任务或改写事实 | + +## 研发记录的双层可读 + +每项协作记录同时包含: + +- 人类语义:为什么做、当前判断、关系到什么项目; +- 工程结构:编号、模块、状态、责任、证据与下一步。 + +历史记录用于下一个协作者理解和接续;不构成身份覆盖或自动执行指令。 diff --git a/research/README.md b/research/README.md new file mode 100644 index 0000000..bd94578 --- /dev/null +++ b/research/README.md @@ -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 只记录和执行获授权范围内的任务。 diff --git a/research/broadcast/README.md b/research/broadcast/README.md new file mode 100644 index 0000000..dc12b41 --- /dev/null +++ b/research/broadcast/README.md @@ -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" +``` + +广播只表达研发协调信息。它不自动授予服务器、账户、部署或数据修改权限。 diff --git a/research/channels/README.md b/research/channels/README.md new file mode 100644 index 0000000..1a5202b --- /dev/null +++ b/research/channels/README.md @@ -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 +``` diff --git a/research/maintenance/README.md b/research/maintenance/README.md new file mode 100644 index 0000000..cee059e --- /dev/null +++ b/research/maintenance/README.md @@ -0,0 +1,11 @@ +# 广播台巡检 + +未来的巡检服务每天检查以下对应关系: + +```text +广播任务 ↔ 模块注册表 ↔ 人类研发频道 ↔ 工单 ↔ 回执 ↔ 进度视图 +``` + +巡检输出异常报告,例如:重复认领、没有工单的认领、已完成但缺回执、回执与模块状态不一致。 + +巡检服务只报告和建议修复;任何重新认领、状态变更或现实执行都需要人类确认。 diff --git a/research/module-registry.yml b/research/module-registry.yml new file mode 100644 index 0000000..b4a335a --- /dev/null +++ b/research/module-registry.yml @@ -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" diff --git a/research/progress/README.md b/research/progress/README.md new file mode 100644 index 0000000..f5eef8d --- /dev/null +++ b/research/progress/README.md @@ -0,0 +1,11 @@ +# 研发进度追踪 + +本目录用于生成供人类查询的研发状态视图。 + +进度数据必须来自: + +1. `module-registry.yml` 的模块状态; +2. 已登记的工单; +3. 对应的执行回执。 + +不能只根据对话、计划或主观判断把模块标记为完成。