docs: record knowledge work item handoff [skip ci]

This commit is contained in:
Your Name
2026-06-03 09:01:11 +08:00
parent 8446a03879
commit ec6cf8d608

View File

@@ -1,3 +1,44 @@
## 2026-06-03Knowledge Base Work Items 接續狀態串接
**背景**統帥追問「KM 需要更新」這類治理告警後續到底由誰處理、陳舊數據怎麼處理,以及前端是否要同步呈現已完成與正在推進的工作。上一輪已把 KM 來源、Incident、Playbook、審核缺口視覺化本輪接續把 Knowledge Base 的陳舊治理缺口接到 AwoooP Work Items讓操作者能直接看到 owner-review queue 的真實狀態與可處理入口。
**本次調整**
- `/zh-TW/knowledge-base` 新增 `Work Items 接續狀態` 區塊,讀取 Hermes KB owner-review queue 與 burn-down endpoint。
- 區塊顯示 `陳舊比例``陳舊 KM``待審核``可處理 / 阻塞``已完成`並列出最高優先處理項、Incident / Playbook 關聯與 stale days / score。
- 新增 `打開 Work Items` 深連結,若 API 回傳 dispatch id會帶到 `/awooop/work-items?project_id=awoooi&work_item_id=...`,讓操作者從 KB 頁直接接續審核工作。
- 主責分工明確呈現Hermes 建立 KM 更新草稿與 owner-review queueOpenClaw 補告警分類、Playbook 與上下文摘要Owner 在 AwoooP Work Items 預覽後才確認寫回。
- 前端加上 `讀取不寫入` 防護呈現;本頁只讀治理狀態,不在讀取時批量改寫 KM。
- `apps/web/messages/zh-TW.json` / `en.json` 補齊 i18n保持鏡像一致。
**本機驗證**
- `cmp -s apps/web/messages/zh-TW.json apps/web/messages/en.json` 通過。
- `git diff --check` 通過。
- `pnpm --dir apps/web exec tsc --noEmit --tsBuildInfoFile /tmp/kb-work-items-20260603.tsbuildinfo` 通過。
- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過KB route size `56.4 kB`
- 本機 Browser桌機與 390px 手機皆顯示 `Work Items 接續狀態`、主責分工、`讀取不寫入` 與 Work Items 入口;`horizontalOverflow=0``canScrollVertical=true`
- 本機因 production API CORS 對 `127.0.0.1` origin 失敗,治理數字以 loading/空狀態驗證排版;真資料改由 production 驗證收斂。
**正式部署**
- Code commit`ebc272a4 fix(web): surface knowledge work item handoff`
- Gitea code-review run`3602` / run number `2496` / success。
- Gitea CD run`3601` / run number `2495` / tests `5074` success、build-and-deploy `5075` success、post-deploy-checks `5076` success。
- Deploy marker`8446a038 chore(cd): deploy ebc272a [skip ci]`
- K8s`awoooi-api``awoooi-web``awoooi-worker` image 均為 `ebc272a4a8d41717dbdc8415d5afac384217d666`
**正式驗證**
- CD post-deployAlert Chain smoke `9/9`、監控覆蓋率 `100.0%`、SourceLink canary recorded、Playwright smoke `5 passed`
- Live API`/api/v1/ai/governance/km-stale-owner-review-burndown?project_id=awoooi``stale_count=2273``total_count=2501``stale_ratio=0.909``threshold=0.2``entries_to_threshold=1773``pending_owner_reviews=10``completed_owner_reviews=1``writes_on_read=false`
- Live API`/api/v1/ai/governance/km-stale-owner-review-completion-queue?project_id=awoooi&status_bucket=all``pending_count=10``ready_count=10``blocked_count=0``completed_count=1``writes_on_read=false``batch_writes_allowed=false`
- Production 桌機:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ebc272a-kb-work-items-prod` 顯示 `90.9%``2,273``10``10 / 0``已完成 1`、Hermes / OpenClaw / Owner 分工與 `讀取不寫入``打開 Work Items``work_item_id=c0a62d49-448b-4223-ae80-1abb6e361260``horizontalOverflow=0``canScrollVertical=true`
- Production 手機 390px同樣顯示 Work Items 接續狀態、治理數字與深連結;`horizontalOverflow=0``canScrollVertical=true`
**進度更新**
- Knowledge Base 產品化可讀性由 `66%` 上修至 `70%`
- 前端設計系統 / i18n / 素材治理由 `54%` 上修至 `56%`
- CI/CD SourceLink / API rollout 健康維持 `100%`
- 首頁產品化入口維持 `80%`AwoooP/HITL 維持 `99.2%`
- 完整 AI 自動化飛輪由 `66%` 小幅上修至 `67%`本輪完成的是「KM 治理告警 → AwoooP Work Items 可追蹤接續」與 owner-review 可視化,不是新增自動修復或自動寫回能力;陳舊 KM 真正降比仍要後續處理 preview / confirm / writeback 流程。
## 2026-06-03Knowledge Base 引用鏈圖與陳舊處理佇列落地
**背景**:統帥持續要求前端從文字牆改成圖、表、流程、拓樸與可快速理解的產品介面。本輪接續 Knowledge Base 品質軌道,新增「引用鏈圖」與「陳舊處理佇列」,讓操作者一眼看出 KM 來源、Incident / Playbook 覆蓋、審核缺口與下一步處理方向。