Merge pull request 'HEL-697: 视觉总监接手整体视觉与代码，记录需求v1.8' (#7) from agent/agent/6f5a7d8d7cb6 into main

2026-10-22 23:05:35 +08:00
parent 4242f8377e 81d7cb523d
commit 3a986726d8
12 changed files with 92 additions and 73 deletions
@@ -10,6 +10,8 @@

 ## 施工和交接

+- 白栖知于主卡评论 `01a163a5-e2a7-7ac8-afdb-991868e721bc` 明确：本项目整体视觉由视觉总监接手设计与实际落地，职责不止审核把关。施工员无法实现对应效果时，由视觉总监直接编写相关代码。本轮对话及沉浸界面交由视觉总监亲自负责；总管负责协调、核对需求和交付，不再以自己的视觉原型替代它接手。此项是CyberGril项目分工，不修改队员在其他项目的全局职责、模型或认证。
+
 - 使用 `docs/requirements/task-handoff-template.md`，写出本次交付及完整需求的关联；完整当前需求始终有效。阶段不做的内容列明承接，不删除需求。
 - 需求、技术方案、阶段范围、实现状态、用户验收分开记录。不得把智能体建议、技术困难、模型登录失败或某阶段通过当作修改需求的授权。
 - 不用“当前一两句”以外的长消息滚动主界面替代已确认的交流体验。长回复需完整可读，具体分句等方案先通过动态小样验证。
@@ -1,12 +1,12 @@
 # CyberGril 需求入口

-当前完整基准：**v1.7**。批准需求继承办法的主卡评论：`01a1635b-b47c-79ed-ac66-9408c7905af9`。
+当前完整基准：**v1.8**。批准需求继承办法的主卡评论：`01a1635b-b47c-79ed-ac66-9408c7905af9`。

 所有新任务、续办、设计、施工、审核先读完整当前需求，再读本次相关来源。只有白栖知明确修改的要求才可变更，阶段范围不能覆盖产品要求。

 | 文件 | 用途 |
 | --- | --- |
-| [current.md](current.md) | 58条完整有效要求：原31条产品决定、13条视觉、3条补充、6条用户整改、4条执行约束、1条交付边界；另列未定项 |
+| [current.md](current.md) | 59条完整有效要求：原31条产品决定、13条视觉、3条补充、6条用户整改、5条执行约束、1条交付边界；另列未定项 |
 | [baseline.json](baseline.json) | 同一份要求的结构化编号、边界和来源 |
 | [coverage.md](coverage.md) / [coverage.json](coverage.json) | 实现与验收状态，未完成项目继续保留 |
 | [changes.md](changes.md) / [changes.json](changes.json) | 后续修改的用户授权及影响 |
@@ -15,7 +15,7 @@
 | [source-manifest.json](source-manifest.json) | 来源文件校验值，防止历史来源被静默改写 |
 | [implementation-verification.md](implementation-verification.md) | 本次实际写入、旧卡迁移与正反向验证记录 |

-`sources/comment-evidence.json` 保存125条来源评论的身份、时间、原话和父评论；正文中的编号可追溯回主卡。原始初轮访谈与完整视觉访谈均用分页取齐，后续材料按关联决定保存。其余来源文档保留原样；其中旧进度、技术推荐、旧待定项不能自动成为当前事实。已经被后续明确决定覆盖的内容，见 current.md 和 changes.md。
+`sources/comment-evidence.json` 保存初版125条来源评论（保留原样）的身份、时间、原话和父评论；正文中的编号可追溯回主卡。原始初轮访谈与完整视觉访谈均用分页取齐，后续材料按关联决定保存。其余来源文档保留原样；其中旧进度、技术推荐、旧待定项不能自动成为当前事实。已经被后续明确决定覆盖的内容，见 current.md 和 changes.md。

 原仓库 `docs/SPEC.md` 是初始构想，不能盖过后续逐项确认：例如旧VRM路线、允许经历改写出生核心等，均不能用于覆盖当前要求。

@@ -31,4 +31,6 @@

 当前没有配置仓库自动CI合并门禁；上述命令作为交付和独立审核的必做项，不声称平台已强制拦截所有修改。

+v1.8新增来源见 `sources/comment-evidence-visual-role-20261022.json`，最新分工见GOV-005。
+
 后续以该入口所记录的最新版本为准，不把v1.7永久钉死为永不可新增的文档。每次新版本必须记录用户明确裁定，保留旧版来源与覆盖关系。
@@ -1,9 +1,9 @@
 {
  "schema_version": 1,
-  "version": "1.7",
-  "approval_comment_id": "01a1635b-b47c-79ed-ac66-9408c7905af9",
+  "version": "1.8",
+  "approval_comment_id": "01a163a5-e2a7-7ac8-afdb-991868e721bc",
  "owner_id": "e5c6c938-db48-4ff9-954f-4fb8b063a132",
-  "scope": "完整要求；版本1.7整合已确认内容并新增用户批准的需求继承约束，不证明已实现或已验收。",
+  "scope": "完整要求；v1.8按用户明确指令新增视觉总监接手及必要代码职责，原58项和已批准边界继续有效，不证明功能已实现或已验收。",
  "requirements": [
    {
      "id": "CG-001",
@@ -683,6 +683,16 @@
        "01a1629c-732f-7559-8417-6f2ea05c7151"
      ],
      "source_document": "sources/integration-plan-v1.md"
+    },
+    {
+      "id": "GOV-005",
+      "category": "执行分工",
+      "topic": "视觉总监接手整体视觉及必要代码",
+      "conclusion": "CyberGril整体视觉由视觉总监接手设计与实际落地，职责不止审核把关；施工员无法写出对应代码时，直接由视觉总监编写。本轮对话与沉浸界面交由视觉总监亲自负责。",
+      "boundary": "总管负责协调、完整需求核对与交付；不再用总管制作替代视觉总监接手。分工限本项目，不修改队员其他项目的全局模型、职责或认证；原产品需求与小样先验收再替换正式界面的边界继续有效。",
+      "source_comment_ids": [
+        "01a163a5-e2a7-7ac8-afdb-991868e721bc"
+      ]
    }
  ],
  "open_items": [
@@ -67,6 +67,16 @@
        "VIS-013"
      ],
      "impact": "约束新旧卡及独立界面小样；不改产品数据、模型与现有服务。"
+    },
+    {
+      "version": "1.8",
+      "approval_comment_id": "01a163a5-e2a7-7ac8-afdb-991868e721bc",
+      "approved_by": "e5c6c938-db48-4ff9-954f-4fb8b063a132",
+      "summary": "新增GOV-005：整体视觉交给视觉总监接手，不止把关；施工员不能实现时由视觉总监直接写代码。",
+      "affected_ids": [
+        "GOV-005"
+      ],
+      "impact": "本项目本轮视觉设计、动效与相应代码责任转给视觉总监；不改现网、数据、全局模型或认证。"
    }
  ]
 }
@@ -5,3 +5,9 @@ v1.7：把原始31项、已确认视觉和后续用户裁定整理到同一入
 原始 v1.6 原样保留。后续生活披露、初始关系和名字的覆盖见 current.md 的 AM-001–003 及对应来源，不回写历史。旧文档中的历史进度不作为现在的事实。

 以后每次改需求，记录：原要求、新要求、白栖知明确原话及评论编号、涉及编号、影响范围。智能体建议、实现困难、阶段通过均不能替代用户授权。检查脚本只能检查材料完整性，审核者仍必须核对原话。
+
+## v1.8：视觉总监接手
+
+白栖知明确裁定：整体视觉交给视觉总监接手，而不是把关，甚至若施工员无法写出相应代码，直接让视觉总监写代码
+
+来源评论：`01a163a5-e2a7-7ac8-afdb-991868e721bc`。旧分工为总管因环境失败接手制作、后续视觉总监只把关；现按GOV-005交视觉总监亲自设计与落地，必要时直接写代码。本次不改变产品功能与原验收边界。
@@ -1,5 +1,5 @@
 {
-  "baseline_version": "1.7",
+  "baseline_version": "1.8",
  "items": [
    {
      "requirement_id": "CG-001",
@@ -348,6 +348,16 @@
      "status": "未完成或未整体验收；不得据旧样机或测试数字声称已满足",
      "evidence": [],
      "next_step": "按完整需求与接入批次落实，交付时补真实证据"
+    },
+    {
+      "requirement_id": "GOV-005",
+      "status": "用户恢复原运行时后，视觉总监已在HEL-793真实运行；设计与代码由其亲自负责",
+      "evidence": [
+        "01a163a5-e2a7-7ac8-afdb-991868e721bc",
+        "01a163be-0bbc-7a74-8dc1-a3bcee89cc58",
+        "running:01a163bc-9134-75e4-aa28-71c6371ff692"
+      ],
+      "next_step": "视觉总监交实际样图和动态代码；总管按完整需求核对后交用户验收，保持用户设定的运行时"
    }
  ]
 }
@@ -62,5 +62,6 @@
 | GOV-003 | 本版本已写入规则和检查；主分支合入及后续实际执行仍需核验 | 独立审核文档、检查脚本与旧卡迁移；后续卡逐张执行 |
 | GOV-004 | 用户不满意当前对话与整体沉浸体验，独立小样待制作及验收 | 本轮批准的界面动态小样 |
 | DEL-001 | 未完成或未整体验收；不得据旧样机或测试数字声称已满足 | 按完整需求与接入批次落实，交付时补真实证据 |
+| GOV-005 | 用户恢复原运行时，视觉总监已在HEL-793真实运行 | 由其交实际设计与代码，保持用户配置 |

 详细证据位于 `coverage.json`；空证据表示尚无本基准下整项合格证据，不表示需求取消。
@@ -1,6 +1,6 @@
-# CyberGril 完整当前需求 · v1.7
+# CyberGril 完整当前需求 · v1.8

-完整要求；版本1.7整合已确认内容并新增用户批准的需求继承约束，不证明已实现或已验收。
+完整要求；版本1.8保留原完整要求并新增用户明确的视觉总监接手分工，不证明已实现或已验收。

 ## 阅读与效力

@@ -502,6 +502,14 @@

 关联全文：`sources/integration-plan-v1.md`。

+## GOV-005 · 视觉总监接手整体视觉及必要代码
+
+CyberGril整体视觉由视觉总监接手设计与实际落地，职责不止审核把关；施工员无法写出对应代码时，直接由视觉总监编写。本轮对话与沉浸界面交由视觉总监亲自负责。
+
+边界：总管负责协调、完整需求核对与交付；不再用总管制作替代视觉总监接手。分工限本项目，不修改队员其他项目的全局模型、职责或认证；原产品需求与小样先验收再替换正式界面的边界继续有效。
+
+来源评论：`01a163a5-e2a7-7ac8-afdb-991868e721bc`。
+
 ## 尚未确定或尚未验证

 ### T-01 · 八字映射细则
@@ -1,67 +1,14 @@
 {
-  "baseline_version": "1.7",
-  "read_commit": "498429399812a0776dadd4b56662d31b455a9ea5",
+  "baseline_version": "1.8",
+  "read_commit": "4242f8377e350e5f17e836d275c15b0f099bf109",
  "requirement_ids": [
-    "CG-001",
-    "CG-002",
-    "CG-003",
-    "CG-004",
-    "CG-005",
-    "CG-006",
-    "CG-007",
-    "CG-008",
-    "CG-009",
-    "CG-010",
-    "CG-011",
-    "CG-012",
-    "CG-013",
-    "CG-014",
-    "CG-015",
-    "CG-016",
-    "CG-017",
-    "CG-018",
-    "CG-019",
-    "CG-020",
-    "CG-021",
-    "CG-022",
-    "CG-023",
-    "CG-024",
-    "CG-025",
-    "CG-026",
-    "CG-027",
-    "CG-028",
-    "CG-029",
-    "CG-030",
-    "CG-031",
-    "VIS-001",
-    "VIS-002",
-    "VIS-003",
-    "VIS-004",
-    "VIS-005",
-    "VIS-006",
-    "VIS-007",
-    "VIS-008",
-    "VIS-009",
-    "VIS-010",
-    "VIS-011",
-    "VIS-012",
-    "VIS-013",
-    "AM-001",
-    "AM-002",
-    "AM-003",
-    "UX-001",
-    "UX-002",
-    "UX-003",
-    "UX-004",
-    "UX-005",
-    "UX-006",
    "GOV-001",
    "GOV-002",
    "GOV-003",
    "GOV-004",
-    "DEL-001"
+    "GOV-005"
  ],
-  "deliverable": "完整需求、来源档案、执行约束和检查命令，项目与旧卡统一入口；不是产品功能交付",
+  "deliverable": "按用户明确指令记录视觉总监接手设计与相应代码职责，并交接本轮返工",
  "acceptance": [
    "58项原意、边界、来源完整；初轮及视觉对话取齐",
    "版本变更、来源、覆盖、交接缺项检查可运行",
@@ -72,11 +19,17 @@
    "R1修正与R2–R7真实接入继续保留",
    "CI自动合并门禁尚未配置，当前检查由交付与审核执行"
  ],
-  "requirement_changes": [],
+  "requirement_changes": [
+    {
+      "approval_comment_id": "01a163a5-e2a7-7ac8-afdb-991868e721bc",
+      "requirement_id": "GOV-005"
+    }
+  ],
  "verification": [
-    "58项正向结构与交接检查通过",
-    "4项反向检查均拦截：覆盖漏项、历史来源改动、改需求不升版、过期交接",
-    "项目说明和仓库资源回读一致；39张未关闭子卡和主卡入口逐张回读，原状态和负责人未改",
-    "独立审核待总工执行，仓库主分支尚未合入；此处不声称CI门禁已配置"
+    "59项需求及交接检查通过；原始来源和变更历史保留",
+    "项目规则、主卡与返工卡已明确视觉总监亲自接手设计与相应代码",
+    "用户手动恢复原运行时后，HEL-793运行01a163bc-9134-75e4-aa28-71c6371ff692真实开始；已读旧稿与样图并检查浏览器；没有重复派工",
+    "追溯确认此前2026-10-22T09:31:24Z的运行时变更来自总管执行01a162f2-61a5-7c6a-9704-44c8e15219ff，未经用户事先批准；已向用户如实说明",
+    "主卡恢复in_progress；用户设定的运行时、模型与认证未再更改，正式界面及用户数据保持原状"
  ]
 }
@@ -6,5 +6,6 @@
  "frontend-architecture-v1.md": "eb05f1707a932014d613072e8c5d95bc8d6a0281390dc93c000d63851ecbbc86",
  "product-decisions-v1.6.json": "ccc5c50c5604385208eb054caac01e27fc63367dac7731e1be9775a1e5cf46ab",
  "visual-confirmation-v2.md": "6e0229aaf693f215cc9dcc647be694aeafb3770683b21bb7e3e30291af60255a",
-  "integration-plan-v1.md": "454af1d4a3b0360d33aea9c0e97f738b320968ba7be68e012a5fcec6f6ed0169"
+  "integration-plan-v1.md": "454af1d4a3b0360d33aea9c0e97f738b320968ba7be68e012a5fcec6f6ed0169",
+  "comment-evidence-visual-role-20261022.json": "ecf30eb323129dca2a0d9c2ff2e0163884ee94d3fc7828b0540cd45f03103797"
 }
@@ -0,0 +1,10 @@
+[
+  {
+    "id": "01a163a5-e2a7-7ac8-afdb-991868e721bc",
+    "author_type": "member",
+    "author_id": "e5c6c938-db48-4ff9-954f-4fb8b063a132",
+    "content": "整体视觉交给视觉总监接手，而不是把关，甚至若施工员无法写出相应代码，直接让视觉总监写代码",
+    "created_at": "2026-10-22T12:46:18Z",
+    "parent_id": "01a1639b-8416-7b0b-8dbf-0de16c257cb5"
+  }
+]
@@ -21,7 +21,13 @@ def check(handoff=None, base_ref=None):
    rows = baseline['requirements']
    ids = [r['id'] for r in rows]
    known = set(ids)
-    evidence = {c['id']: c for c in read(DOCS / 'sources/comment-evidence.json')}
+    evidence = {}
+    for path in sorted((DOCS / 'sources').glob('comment-evidence*.json')):
+        for comment in read(path):
+            old = evidence.get(comment['id'])
+            if old and old != comment:
+                errors.append(f'同一来源评论出现不同记录：{comment["id"]}')
+            evidence[comment['id']] = comment
    if len(ids) != len(known):
        errors.append('重复的需求编号')
    text = (DOCS / 'current.md').read_text(encoding='utf-8')