23 專案配置檔案機制詳解

📌 問題背景

主公提問

每一個人事實上會有許多個專案，當我們把 Skill 安裝到學員電腦時，沒有專案，接著給 Starter Kit 建立自己的專案，接著又會建立更多專案。針對專案專用 Skill 的 Hardcode 問題，列出清單，建議解決方案，以及方案一「專案配置檔案機制」怎麼配置？

核心矛盾：Skill 安裝時不知道學員的專案名稱，但部署指令需要 --project-name 這類具體值，導致 8 項 Skill 內部直接寫死 wholistics，無法用於第二個以後的專案。

🔴 Hardcode 問題清單（8 項）

Skill	Hardcode 內容	優先級
upload-html	--project-name wholistics	🔴 高
updatememo	部署目標固定 wholistics	🔴 高
wh-resetproject	整個流程圍繞 wholistics	🟡 中
updatesk	更新 wholistics 的 skills-list	🟡 中
renewhtml	指定專案路徑固定	🟡 中
aiworkforme-update	專為 aiworkforme 網站設計	🟢 低
torecord	固定記錄路徑	🟢 低
readrecord	固定讀取路徑	🟢 低

💡 三大解決方案總覽

方案	核心概念	適用情境
方案一：專案配置檔案	每專案放置 .wb-project，Skill 自動讀取	⭐ 推薦長期
方案二：動態參數傳入	執行時附加 upload-html my-project	簡易快速
方案三：工作目錄偵測	.wb-project 標記檔自動識別	自動化偵測

📁 方案一詳解：專案配置檔案機制

配置檔案格式 A：JSON（workbuddy.config）

{ "project": { "name": "my-website", "type": "cloudflare-pages", "account_id": "2f2795bc4a98928375b23c36140ba33b" }, "deployment": { "source": "./dist", "memo_dir": "./memo" }, "skills": { "upload-html": { "project_name": "my-website" }, "updatememo": { "enabled": true, "target_project": "my-website" } } }

配置檔案格式 B：KEY=VALUE（.wb-project）推薦學員使用

# 專案基本資訊 PROJECT_NAME=my-website PROJECT_TYPE=cloudflare-pages ACCOUNT_ID=2f2795bc4a98928375b23c36140ba33b # 部署配置 DEPLOY_SOURCE=./dist DEPLOY_ENABLED=true # Skill 特定配置 UPLOAD_HTML_PROJECT=my-website UPDATEMEMO_ENABLED=true

Skill 讀取邏輯（由貞執行時）

1

偵測當前工作目錄

讀取對話中提及的路徑或 workspace

2

尋找配置檔（優先順序）

① ./workbuddy.config → ② ./.wb-project → ③ ~/.workbuddy/config（全域預設）

3

讀取專案名稱與配置

解析 PROJECT_NAME、ACCOUNT_ID 等值

4

動態代入執行

--project-name ${PROJECT_NAME} 替代 Hardcode

實際使用情境：學員建立新專案

# Step 1：建立專案目錄 mkdir my-blog cd my-blog # Step 2：建立配置檔（未來可由 project-init Skill 自動生成） echo "PROJECT_NAME=my-blog" > .wb-project echo "ACCOUNT_ID=2f2795bc4a98928375b23c36140ba33b" >> .wb-project # Step 3：執行 Skill（自動讀取 .wb-project，無需指定參數） "upload-html" → 自動部署到 my-blog "updatememo" → 自動更新 my-blog 備忘

🛠️ 配套 Skill 建議

新 Skill	功能	說明
project-init	初始化新專案	自動生成 .wb-project，引導填寫專案名稱
project-config	查看/修改配置	顯示當前 .wb-project 內容，支援修改
project-switch	切換預設專案	在多專案間切換預設操作目標

📅 分階段實施建議

第一階段（立即）：修改高優先級 Skill

upload-html、updatememo 支援方案二（參數傳入）作為快速解決

第二階段（1~2 週）：建立 .wb-project 標準

定義格式規範，更新中優先級 Skill（wh-resetproject, updatesk, renewhtml）

第三階段（長期）：project-init Skill

新學員執行後自動生成 .wb-project，一次配置，所有 Skill 自動適配

✅ 最終結論

方案一（配置檔案機制）是最優解：學員只需在每個新專案目錄執行一次 project-init，之後所有 Skill 即可自動識別專案，徹底解決 Hardcode 問題，支援無限多個專案並存。