整合 #57 犯錯檢討 · #58 過程回顧 · #59 通用性普查
以「快速製作 Starter Kit、完美交付教學成果」為終極目標
| 項目 | 內容 |
|---|---|
| 時間 | 10:00(上午雙站同步階段) |
| 錯誤 | aiworkforme index.html 原有 student nav 被 workskm nav 整段覆蓋 |
| 根本原因 | 未先讀取 aiworkforme index.html 原始 nav,直接做整段替換 |
| 影響 | aiworkforme 學生端導航全部失效,30分鐘還原 |
| 預防原則 | nav 同步:只可「增加連結/修正死連結」,不可整段覆蓋 |
| ID | 技能名 | 通用原因 |
|---|---|---|
| 2 | allcompare | 接收兩 URL 即可比對,無路徑依賴 |
| 3 | lettercompare | 接收檔案路徑/URL 參數,無硬編碼 |
| 5 | transcompare | 純文本比對邏輯 |
| 6 | renewpr | 複製/更新邏輯,讀取用戶指定的來源 |
| 15 | skill-bootstrap | Bootstrap 腳本不含路徑,依賴調用者傳入 |
| 16 | skill-project-deploy | 匯出腳本設計時已考慮跨電腦 |
| 17 | new-project | 接收 project-name 參數,無硬編碼 |
| 19 | identity-setup | 引導用戶對話式建立,結果寫入用戶目錄 |
| 20 | memory-init | 對話式引導,結果寫入用戶目錄 |
| 21 | automation-setup | 接收 crontab/rrule 參數,無路徑 |
| 22 | skill-template | 模板本身不帶路徑 |
| 23 | deploy-status | 接收 CF API token + account-id,無硬編碼 |
| 24 | copywriting-gen | 純文案生成邏輯 |
| 25 | remote-cmd-template | 模板庫,無狀態 |
| 26 | course-progress | 接收用戶指定的進度檔路徑 |
| 27 | aiworkforme-update | 支援 .wb-config.json 自動偵測 |
| 30 | ideatorich | 接收 URL/檔案路徑,無硬編碼 |
| 33–35 | torecord-doc / merge-doc / mergehtml | 接收路徑參數 |
| 36–39 | downloadsite / replace-content / replaceimage / text-residue-check | 接收路徑參數 |
| 42 | deploy-rollback | 接收 deployment-id + CF 參數 |
| 45–47 | answerch / toanswerch / answerch-clean | 接收錯誤關鍵字或檔路徑參數 |
| ID | 技能名 | 依賴項 | 配置方式 |
|---|---|---|---|
| 1 | upload-html | CF_API_TOKEN + CF_ACCOUNT_ID | 環境變量(User 層級) |
| 4 | international-promotion-deploy | 翻譯 API key + CF 憑證 | 環境變量 |
| 8 | cloudflare-guard | CF_API_TOKEN + 目標目錄 | .wb-config.json |
| 9 | wh-resetproject | CF_API_TOKEN + 舊專案ID | 環境變量 + 參數 |
| 10 | delete-olddata | CF_API_TOKEN + 專案名 | 環境變量 + 參數 |
| 11 | updatesk | IDENTITY.md 路徑 | 改用 %USERPROFILE% |
| 12 | updatememo | 部署目錄 + 專案名 | .wb-config.json |
| 14 | readrecord | 工作備忘目錄 | .wb-config.json |
| 31 | torecord | 記憶目錄 | .wb-config.json |
| 43 | skill-health-check | skills 目錄路徑 | .wb-config 或環境變量 |
| 44 | memory-compact | 記憶目錄路徑 | .wb-config 或環境變量 |
| ID | 技能名 | 硬編碼內容 | 替代方案 |
|---|---|---|---|
| 18 | clawbot-setup | 微信 Webhook URL(個人持有) | 學生自建,或供模板 |
| 41 | nav-editor | 硬編碼 aiworkforme 路徑 | 參數化目標路徑 |
| 28 | content-studio | 僅規劃,串接未實現 | 完成串接開發 |
| 29 | merge-docx | 硬編碼 docx 路徑 | 參數化目標路徑 |
| 13 | skillcompare | 依賴特定工作備忘目錄結構 | 參數化基目錄 |
| 7 | renewhtml | 依賴 renewpr 的輸出路徑 | 統一用 .wb-config |
const DEPLOY_DIR = process.argv[2] || 'C:\\Users\\Administrator\\WorkBuddy\\wh-all-deploy';C:\Users\Administrator\.workbuddy\IDENTITY.md。%USERPROFILE%\.workbuddy\IDENTITY.md(Windows)或 ~/.workbuddy/IDENTITY.md(跨平台)。
C:\Users\Administrator\WorkBuddy\20260410015051\.workbuddy\memory\~ 為基準動態推導。
CF_ACCOUNT_ID = "2f2795bc4a98928375b23c36140ba33b"。今天在主公電腦上驗證:同一電腦(Administrator)、同一帳號(由貞)、同一 CF Token,管理 workskm / aiworkforme / _upwholistics / wh-all-deploy 四個專案。
~/.workbuddy/skills/ → 單一技能庫學生在自己的電腦上,通過 Starter Kit 建立自己的專案,使用由貞的技能系統。此情境面臨五個全新挑戰:
| 挑戰 | 問題 | 解決方案 |
|---|---|---|
| 🎛️ 路徑差異 | 學生 User 名稱不是 Administrator,Home 目錄不是 C:\Users\Administrator | 全部改用 ~ 或 %USERPROFILE% 變量 |
| 🔑 CF 帳號 | 學生使用自己的 CF 帳號,不是主公的 | Starter Kit 提供 env-setup 指引,學生自設 CF_API_TOKEN |
| 👤 身份系統 | SOUL.md / IDENTITY.md / USER.md 需重新初始化 | identity-setup 技能支援引導式建立 |
| 📁 專案路徑 | 學生可能將專案放在 D:\MySite 而非 C:\Users\...\WorkBuddy | .wb-config.json 讓技能自己找到專案根目錄 |
| 🧠 記憶系統 | daily memory 目錄不在預期位置 | memory-init 引導 + .wb-config.json 指定 memoryDir |
技能市場上,技能作者發布技能,萬名用戶各自下載、安裝到自己的 WorkBuddy。
aiworkforme-starter-kit/
├── index.html ← 學生首頁(替換姓名、標語即可)
├── knowbase/
│ └── memodata.html ← 資源中心(已有框架,替換內容)
├── skills-list.html ← 技能廣場(已接入 manifest.json)
├── manifest.json ← 技能清單(49項,學生可增刪)
├── .wb-config.json ← ⚠️ 學生需填寫自己的 CF 專案名
├── README.md ← 部署三步驟說明(env-setup → identity-setup → deploy)
└── .workbuddy/
├── SOUL.md ← 學生自定義AI人設
├── IDENTITY.md ← 學生身份設定
└── USER.md ← 學生基本資料
包含全部8個核心檔案 + 詳細 README.md。學生從零開始,3小時可完成部署。
示範專案 aiworkforme 的精簡鏡像,無需修復 Bug 即可交付。學生用主公的 CF Token 快速上線體驗。
| 層級 | 名稱 | 取值方式 | 範例 | 可否硬編碼 |
|---|---|---|---|---|
| L1 | 系統標準 | ~/.workbuddy/ 或 %USERPROFILE%\.workbuddy\ |
IDENTITY.md、MEMORY.md、skills/ | ✅ 可 |
| L2 | 專案配置 | 讀取 .wb-config.json |
deployDir、projectName、memoryDir | ✅ 可 |
| L2 | 環境變量 | $CF_API_TOKEN、$TRANSLATE_KEY |
CF Token、翻譯 API Key | ✅ 可 |
| L3 | 用戶指定 | 技能執行時由用戶傳入參數 | 目標 HTML 路徑、部署 URL | ✅ 可 |
C:\Users\Administrator\WorkBuddy\...、2f2795bc4a98928375b23c36140ba33b(CF Account ID)均屬禁止之列。
{
"version": "1.0",
"project": "my-student-site", // Cloudflare Pages 專案名
"deployDir": ".", // 部署目錄(. = 當前目錄)
"memoryDir": "../.workbuddy/memory", // 相對於 deployDir 的記憶目錄
"accountId": "YOUR_ACCOUNT_ID", // 學生填自己的,或留空從環境變量讀
"skills": [ // 此專案適用的技能清單
"upload-html",
"updatememo",
"ideatorich"
],
"excludedPaths": [ // 部署時排除的路徑
"node_modules",
".workbuddy",
".git"
]
}
.gitignore(如有的話),不提交到公共 repo。敏感欄位(如 accountId)可選,系統優先讀取環境變量。
| 資訊類型 | 存放位置 | 是否上傳市場 |
|---|---|---|
| CF_API_TOKEN | 環境變量(User 層級) | ❌ 否 |
| CF_ACCOUNT_ID | 環境變量 或 .wb-config.json | ⚠️ 可 |
| 翻譯 API Key | 環境變量 | ❌ 否 |
| 技能模板腳本 | SKILL.md / scripts/ | ✅ 是 |
| 默認導航結構 | index.html(不含內容) | ✅ 是 |
| 個人回憶/記錄 | MEMORY.md / daily/*.md | ❌ 否 |
| 身份設定 | SOUL.md / IDENTITY.md / USER.md | ❌ 否 |
| 時間點 | 學生完成指標 | 驗證方式 |
|---|---|---|
| 第1小時 | ✅ 成功架設自己的網站(Cloudflare Pages) | 提供自己的 .pages.dev URL |
| 第2小時 | ✅ 使用 ideatorich 收集構想 → 轉化為網站內容 | 展示一個 knowbase/ 頁面 |
| 第2.5小時 | ✅ 使用 torecord 記錄當日學習內容 | 展示 MEMORY.md 有一筆記錄 |
| 第3小時 | ✅ 使用 updatememo 更新自己的資源中心 | 展示更新後的 index.html |
| 第3小時 | ✅ 使用 upload-html 完成重新部署 | 展示新的 deployment URL |
~/.workbuddy/ 之外的系統目錄~、$HOME、%USERPROFILE% 或 .wb-config.json。~/.workbuddy/IDENTITY.md 等系統約定路徑。| 工作項 | 說明 | 負責 |
|---|---|---|
| 建立完整版 Starter Kit 目錄 | 8個核心檔案 + README.md | 由貞 |
| 製作 README.md 部署說明 | 含 env-setup 三步驟 + 故障排查 | 由貞 |
| 準備 Starter Kit Lite 版 | 即時可用,示範用 | 由貞 |
| 完成 Phase 0 空白環境實測 | 用自己的帳號跑完整流程 | 主公 |
| 更新 skill-template | 將「通用性四層原則」寫入模板 | 由貞 |
| 工作項 | 說明 | 負責 |
|---|---|---|
| 撰寫三小時教學講義 | 含 H1/H2/H3 三模組 + 習題 | 主公 |
| 製作 ideatorich 教學素材 | 提供範例構想(可用現有內容) | 由貞 |
| 首期學員招募 | 1-3名種子學員 | 主公 |
| 首期教學交付 | 根據實際反饋調整 Phase 0-1 | 共同 |
| 根據反饋更新 Starter Kit | 納入學生實際遇到的問題 | 由貞 |
| 工作項 | 說明 | 負責 |
|---|---|---|
| 通用技能審核清單 | 將「七關審查」格式化為可執行清單 | 由貞 |
| 建構 skill-health-check v2 | 自動檢測 SKILL.md 含硬編碼路徑 / Token | 由貞 |
| 市場交易合約 | 版權、收益分成、責任聲明 | 主公 |
| 技能上架指引文件 | 學生髮布技能到市場的完整說明 | 由貞 |
| 市場Beta測試 | 邀請學員試用上架流程 | 共同 |
整合報告 #60 · 由貞出品 · 2026-04-11 13:10
整合自:#57 犯錯檢討報告 · #58 過程回顧與優化計畫 · #59 技能通用性與市場規範建議書
相關備忘:#21 32項通用性分析 · #29 33項通用性分析