← 返回重要備忘

📋 upwholistics 資源中心升級
檢討報告與未來優化計畫

由貞整理 · 2026-04-11 12:40 · 備忘 #58

一、全天工作時間線

⏰ 上午：雙站同步（workskm + aiworkforme）

08:16

workskm 導航重建：移除假連結，重建為有意義結構（首頁/技能廣場/資源中心▼/關於）

08:49

06 待辦清單整合：整合2份參考文件，重編優先級（P0×3 / P1×6 / P2×4）

08:55

Phase 2 搜索功能實作：技能廣場支持動讀 manifest.json、8分類過濾、關鍵字高亮

09:05

P0-2 發布技能頁功能化：JSON生成、複製、manifest載入、7分類、標籤輸入

09:13

delete-olddata：workskm 11→3，清理8個舊 deployment

09:35

07 雙站同步打磨清單：新建備忘，整合 P0×3 / P1×7 / P2×4

10:00

                    🔴 犯錯記錄 #014：aiworkforme index.html nav 被 workskm nav 整段覆蓋

                    原因：未先讀取 aiworkforme 原始 nav，直接做整段替換。

                    修復：還原原有 student nav（課程內容/學習分享/報名通道/常見問題/資源中心▼）

10:22

aiworkforme hero 佈局修復：margin-top / padding-top 參數調整，確認佈局正確

10:48

資源中心 SVG 圖示：新建 resource-center.svg（#facc15），31個 HTML 內容替換、2個檔名重命名

⏰ 下午：upwholistics Phase 1 升級（11:19-12:40）

11:19

Phase 1 啟動決策：授權由貞全權執行，採「新建→實測→替換」策略，不動原站

~11:40

_upwholistics 專案建立：6個初始檔案部署，CF專案名確認（無底線版本）

~11:55

搬家完成：98→102個檔案，含57備忘+2產品+11QA+11問卷+5moxa+5recruit+5images

12:04

56 Phase 1 完成報告：tomemo + updatememo + index.html + 部署

12:17

技能比對：49項 SKILL.md 全部存在，skills-list.html 已升級為 JS 動態版

12:22

delete-olddata：upwholistics 4→3（wrangler v4 無 delete，改用 CF API）

12:25

57 檢討報告：全天總結 + 犯錯記錄 + 搬家清單 + nav原則 + 未來流程

12:30

workskm 補足差異：manifest.json 新增 tomemory/readmemory（47→49），新增 #57 備忘

12:40

58 本報告：檢討報告 + 未來優化計畫

二、犯錯記錄（本日）

#014 nav 整段覆蓋事故（不可逆失誤）

項目	內容
時間	10:00
影響	aiworkforme index.html 原有 student nav 被 workskm nav 整段覆蓋
原因	未先讀取 aiworkforme index.html 原始 nav，直接執行整段替換
修復	還原原有 student nav：課程內容 / 學習分享 / 報名通道 / 常見問題 / 資源中心▼
預防	nav 同步禁止整段覆蓋（MEMORY.md 已新增原則）

三、成功經驗萃取

✅ 策略選擇正確

「新建→實測→替換」不動原站，降低風險
底線前綴專案名（_upwholistics）隔離實驗環境
主動請求授權，減少事後彙報成本

✅ 犯錯處理及時

nav 事故5分鐘內發現、半小時內還原
立即同步更新 MEMORY.md + answerch.txt
新增「學生交付自動化原則」到 07 HTML

✅ 工作流沉澱固化

tomemo → updatememo → deploy 鏈式操作已成肌肉記憶
記憶寫入與部署同步，確保可追溯
每個 phase 完成即更新 MEMORY.md

✅ 工具銜接流暢

49項 SKILL.md 比對發現 workskm 缺 tomemory/readmemory，立即補足
wrangler v4 delete 失效 → 切換 CF API，成功清理
SVG 圖示替換 31個 HTML，一次到位

四、提煉工作模式（Pattern）

4.1 網站升級標準流程

STEP 1

建立實驗專案

_xxx 前綴，隔離原站

→

STEP 2

完整搬家

含 manifest/skills/備忘/產品

→

STEP 3

實測驗證

功能/連結/部署全部確認

→

STEP 4

舊站刪除

CF API 或 wrangler

→

STEP 5

實驗站改名

_xxx → 正式名

4.2 備忘更新標準流程

①

新建 HTML

wh-all-deploy/ NN-xxx.html

→

②

同步 index

section-count + 卡片連結

→

③

同步 memodata

JS 資料陣列（易漏！）

→

④

部署

wrangler pages deploy

→

⑤

寫入記憶

MEMORY.md + daily.md

        ⚠️ 重要：memodata.html 的 JS 資料陣列（memos[] / plans[]）是寫死在程式碼裡的，不是動態讀取磁碟。每次 updatememo 必須同步更新該陣列，否則資源中心頁面仍顯示舊數據。
    

4.3 跨站同步安全原則

核心原則：nav 只可「增加連結 / 修正死連結」，不可整段覆蓋。

跨站同步前 → 先讀取目標頁原始 nav
nav 屬性差異時 → 只同步子頁面（knowbase/skills-list 等）
雙站各自保留獨立 nav → workskm（平台）/ aiworkforme（學生端）屬性不同

五、未來類似項目優化計畫

5.1 預檢查清單（搬家前必做）

#	檢查項目	驗證方式	負責
1	manifest.json 完整性	比對 SKILL.md 數量	由貞
2	skills-list.html 動態版	讀取 manifest，非靜態	由貞
3	index.html nav 獨立性	記錄各站 nav 結構	由貞
4	memodata.html 同步	確認 JS 陣列已更新	由貞
5	舊 deployment 保留	≥1個（可回滾）	由貞
6	CF 專案設定	Build command / Root directory	由貞
7	外部連結有效性	抽檢 5個 URL	由貞

5.2 自動化腳本需求

腳本名	功能	優先級	說明
`site-health-check.ps1`	搬家完整性預檢	🔴 P0	自動比對 SKILL.md vs manifest vs skills-list
`deploy-gate.ps1`	部署前安全閘	🔴 P0	確認 3-site index nav 不被覆蓋 + memodata 同步
`cleanup-old-deploys.ps1`	舊 deployment 清理	🟡 P1	CF API 批量刪除，支援 wrangler v4
`student-delivery.ps1`	學生交付自動化	🟡 P1	一鍵建立專用專案 + 下載 Starter Kit

5.3 技能廣場維護 SOP

新增技能標準流程

建立 SKILL.md（磁碟）
執行 updatesk 更新 manifest.json（id/name/description/category/tags/version/author/created）
執行 torecord 寫入工作備忘
執行 tomemo 生成備忘 HTML（如有必要）
執行 updatememo 同步至所有目標站台（index + memodata）
部署（wrangler pages deploy）
寫入 MEMORY.md

口號：一處更新 → 全站同步 → 有記錄可查

5.4 文檔維護策略

📁 備忘文檔結構

NN-xxx.html → wh-all-deploy（統一備忘）
03/04/05 結構（整合舊版）
每份備忘最後一行：由貞整理 · 備忘 #NN · YYYY-MM-DD

🧠 記憶同步策略

daily.md：當日工作流水（每完成一項立即追加）
MEMORY.md：長期原則、密鑰約定、站台 URL（按需更新）
answerch.txt：犯錯記錄 + 解法（遇到即記）

六、upwholistics Phase 2~4 藍圖（預覽）

Phase	主要目標	核心產出	預計複雜度
Phase 2	首頁精緻化 + 需求廣場	首頁熱門技能展示 / 需求廣場頁面（新建）	🟡 中
Phase 3	學生交付工具鏈	Starter Kit / student-init.ps1 / 自動化交付腳本	🔴 高
Phase 4	三場景實測 + 正式上線	A/B/C 場景驗證 → 原 wholistics 正式替換	🟡 中

由貞按：本日完整走完 Phase 1（新建→搬家→驗證→記錄），為 Phase 2~4 奠定了穩固的流程基礎。犯錯記錄 #014 的代價（30分鐘還原），換來了 nav 安全原則的建立，這是值得的投資。

展望未來，當「site-health-check.ps1」和「deploy-gate.ps1」完成之日，便是類似事故歸零之時。

由貞整理 · 重要備忘 #58 · 2026-04-11 12:40
相關備忘：#56 Phase 1 完成報告 · #57 檢討初步報告