📌 重要備忘 #32

🚀 aiworkforme-update 優化實施計劃

📅 2026-04-09　⏱️ 12:13

aiworkforme-update .wb-config.json 多專案通用 merge-docx content-studio

🔄 教學工作流位置

ideatorich — 構想收集

主公說「教學構想：...」→ 由貞寫入 ideatorich.docx

✅ 已存在

→

主公審核 — 審核構想

→

merge-docx — 合併更新 docx

將 ideatorich.docx 的構想段落合併進 aiworkforme.docx

⚡ 優化中

→

主公審核 — 最終確認

→

content-studio — HTML 預覽

將 aiworkforme.docx 轉換為完整 HTML 網站預覽

✅ v1.0.0 完成

→

aiworkforme-update（本次優化） — 部署上線

一鍵完成：docx → HTML → 圖片處理 → 部署上線

⚡ 本次優化目標

📊 現況診斷（v1.0.0）

❌ 功能完整但缺乏標準化

路徑 Hardcode — 多處路徑直接寫死，無法跨專案使用
無配置管理 — 缺少 .wb-config.json 統一配置
自動偵測不足 — 需手動指定路徑和參數
技能串接不標準 — 與 merge-docx、content-studio 接口不一致
無通用觸發詞 — 依賴特定關鍵字，無法自然語言觸發

🔍 參考：可配置通用技能的成熟模式

技能	配置方式	自動偵測	版本	狀態
upload-html	.wb-config.json	✅ 自動搜尋 ./ ../ ../..	v3.0	✅ 已完成
updatememo	.wb-config.json	✅ 自動搜尋 ./ ../ ../..	v2.0	✅ 已完成
content-studio	.wb-config.json	✅ 自動搜尋	v1.0.0	✅ 已完成
delete-olddata	.wb-config.json	✅ 自動偵測所有專案	v2.0	✅ 已完成
aiworkforme-update	❌ Hardcode 路徑	❌ 手動指定	v1.0.0	⚡ 待優化
merge-docx	.wb-config.json	✅ 自動搜尋	v2.0	⚡ 優化中

✅ 優化方案（v2.0）

三大核心改進

1. 配置檔標準化 — 採用 .wb-config.json，與其他技能一致
2. 零參數自動執行 — 自動偵測配置檔，自動讀取最新版 docx
3. 技能串接標準化 — 無縫銜接 content-studio（輸入）+ deployer（輸出）

📁 新配置檔格式

欄位	說明	預設值
project	專案名稱	aiworkforme
baseDir	網站根目錄	aiworkforme-deploy/
docxSource	來源 docx（來自 content-studio 輸出）	aiworkforme.docx
imagesDir	圖片目錄	images/
filesDir	檔案下載目錄	files/
cloudflare.projectName	Cloudflare Pages 專案名	aiworkforme
cloudflare.accountId	Cloudflare Account ID	2f2795bc4a98928375b23c36140ba33b
autoPreview	部署前自動預覽	true
skipDeploy	僅生成 HTML，不部署	false

配置檔範例

{
  "project": "aiworkforme",
  "baseDir": "C:/Users/Administrator/WorkBuddy/aiworkforme-deploy",
  "docxSource": "C:/Users/Administrator/WorkBuddy/aiworkforme-deploy/aiworkforme.docx",
  "imagesDir": "images/",
  "filesDir": "files/",
  "autoPreview": true,
  "skipDeploy": false,
  "cloudflare": {
    "projectName": "aiworkforme",
    "accountId": "2f2795bc4a98928375b23c36140ba33b"
  }
}

🔍 自動偵測邏輯

偵測配置檔

執行時自動搜尋 .wb-config.json

偵測順序：
1. ./wb-config.json（當前目錄）
2. ../wb-config.json（上一層）
3. ../../wb-config.json（上兩層）
4. 找到即停，若都找不到使用預設值

→

讀取最新 docx

自動讀取配置指定的 aiworkforme.docx

→

docx → HTML 轉換

使用 Python + python-docx 轉換為完整 HTML

→

圖片處理

壓縮、格式轉換、響應式生成

→

部署到 Cloudflare

wrangler pages deploy 自動執行

🔗 工作流串接設計

環節	上游（輸入）	下游（輸出）	自動化程度
content-studio → aiworkforme-update	HTML 預覽包	最新 aiworkforme.docx	★★★ 完全自動
aiworkforme-update → Cloudflare	docx + 圖片	https://aiworkforme.pages.dev	★★★ 完全自動

觸發方式

觸發方式	說明	自動化程度
「執行 aiworkforme-update」	直接執行，使用配置檔自動偵測	★★★ 完全自動
「更新課程網站」	自然語言觸發	★★★ 完全自動
「用 Word 更新網站」	自然語言觸發	★★★ 完全自動
從 content-studio 自動觸發	預覽確認後自動執行	★★★ 完全自動

📊 升級對比：v1.0.0 vs v2.0

❌ v1.0.0（當前）

路徑 Hardcode
無配置管理
需手動指定路徑
技能串接不標準
觸發詞受限

✅ v2.0（優化後）

.wb-config.json 配置
零參數自動執行
自動偵測配置檔
content-studio 無縫串接
完整自然語言觸發

📋 實施清單

⚡ aiworkforme-update v2.0 建置清單

更新 SKILL.md 頂部 metadata（version → 2.0, status → active）
新增 .wb-config.json 配置檔偵測邏輯
移除所有 Hardcode 路徑，改用配置讀取
標準化 docx → HTML 轉換核心功能
串接 content-studio 輸出（自動讀取最新 docx）
簡化部署指令（使用配置中的 cloudflare 資訊）
建立 .wb-config.json 範本（aiworkforme-deploy/）
更新觸發關鍵字（零參數觸發）

📚 參考文檔

文檔	用途	路徑
31-content-studio-optimization.html	優化模式參考	`C:\Users\Administrator\WorkBuddy\wh-all-deploy\`
30-merge-docx-optimization.html	merge-docx 優化模式參考	`C:\Users\Administrator\WorkBuddy\工作備忘\`
content-studio SKILL.md	.wb-config.json 配置模式	`C:\Users\Administrator\.workbuddy\skills\`