方案三：工作目錄偵測機制

📌 問題背景

📐 通則：工作目錄偵測機制

核心概念

由貞執行 Skill 時，自動偵測當前工作目錄的特徵檔案（如 .wb-project、.git、package.json 等），識別專案身份，無需主公傳參數，也無需預先配置。

偵測邏輯（由貞執行時自動進行）

標記檔案格式

.wb-project（最輕量，推薦）

PROJECT_NAME=my-blog
PROJECT_TYPE=cloudflare-pages

自動偵測邏輯（由貞執行時）

# 由貞執行時的偽代碼
def detect_project(cwd):
    # 向上遍歷最多 5 層目錄
    for level in range(5):
        current = cwd + ("../" * level)
        
        # 優先尋找 .wb-project
        if exists(current + ".wb-project"):
            return read_project_name(current + ".wb-project")
        
        # 其次 workbuddy.config
        if exists(current + "workbuddy.config"):
            return parse_json(current + "workbuddy.config")["project"]["name"]
    
    # 都找不到 → 詢問主公
    return ask_user("請問當前是哪個專案？")

🔧 範例一：upload-html 改造

改造前（Hardcode 版）

# 固定寫死
npx wrangler pages deploy . --project-name wholistics --commit-dirty true

改造後 — SKILL.md 新增「自動偵測」區段

## 自動專案偵測

由貞執行時自動進行：

1. **偵測當前目錄**（workspace 或對話中提及的路徑）
2. **尋找專案標記**（依序）：
   - ① `.wb-project` → 讀取 PROJECT_NAME
   - ② `workbuddy.config` → 讀取 project.name
   - ③ `package.json` → 讀取 name 欄位
3. **若都找不到** → 詢問主公「請問部署到哪個專案？」

## 執行範例

| 情境 | 主公指令 | 由貞行為 |
|------|---------|---------|
| 有 .wb-project | `upload-html` | 自動讀取 PROJECT_NAME，部署 |
| 無標記檔 | `upload-html` | 詢問「請問專案名稱？」 |
| 在子目錄執行 | `upload-html` | 向上遍歷找到 .wb-project 後部署 |

實際執行流程

# 情境：主公在 C:\Users\...\my-blog\src\ 執行 upload-html
# 該目錄沒有 .wb-project，但上層 my-blog\ 有

由貞偵測：
  ① C:\...\my-blog\src\.wb-project → ❌ 不存在
  ② C:\...\my-blog\.wb-project → ✅ 存在！PROJECT_NAME=my-blog
  
執行指令：
  npx wrangler pages deploy . --project-name my-blog --commit-dirty true

🔧 範例二：updatememo 改造

改造前（Hardcode 版）

# 固定流程
- 複製到 wh-all-deploy/
- 部署到 wholistics 專案
- 連結固定為 wholistics.pages.dev

改造後 — SKILL.md 新增「自動偵測」區段

## 自動專案偵測

由貞執行時自動進行：

1. **偵測當前工作目錄**
2. **尋找專案標記**：
   - `.wb-project` → PROJECT_NAME, DEPLOY_DIR
   - `workbuddy.config` → 完整配置
3. **動態推算路徑**：
   - 若無 DEPLOY_DIR → 預設為 `../{PROJECT_NAME}-deploy/`
4. **若都找不到** → 詢問主公

## 執行範例

| 情境 | 主公指令 | 由貞行為 |
|------|---------|---------|
| 在專案根目錄 | `updatememo` | 自動讀 .wb-project，部署 |
| 在子目錄 | `updatememo` | 向上找到 .wb-project 後部署 |
| 無標記檔 | `updatememo` | 詢問「請問備忘要部署到哪個專案？」 |

實際執行流程

# 情境：主公在 C:\Users\...\my-blog\posts\ 執行 updatememo

由貞偵測：
  向上遍歷找到 C:\...\my-blog\.wb-project
  讀取：PROJECT_NAME=my-blog
  
動態推算：
  DEPLOY_DIR = C:\...\my-blog-deploy\
  BASE_URL   = https://my-blog.pages.dev
  
執行：
  1. 複備忘 → C:\...\my-blog-deploy\25-xxx.html
  2. 更新 index.html 連結 → https://my-blog.pages.dev/25-xxx.html
  3. 部署 → npx wrangler pages deploy ... --project-name my-blog

📊 方案三 vs 方案二 比較

🎯 三方案整合架構

┌─────────────────────────────────────────────┐
│  主公說：「upload-html」                      │
└─────────────────────────────────────────────┘
              ↓
    ┌─────────────────────┐
    │ 有傳參數？           │
    │ → 有：直接使用 $1    │  ← 方案二（覆蓋）
    └─────────────────────┘
              ↓ 無
    ┌─────────────────────┐
    │ 當前目錄有 .wb-project？│
    │ → 有：自動讀取        │  ← 方案三（自動）
    └─────────────────────┘
              ↓ 無
    ┌─────────────────────┐
    │ 全域預設值？         │
    │ → 有：使用預設       │  ← 備用
    └─────────────────────┘
              ↓ 無
    ┌─────────────────────┐
    │ 詢問主公            │
    │ 「請問部署到哪個專案？」│
    └─────────────────────┘

📋 後續行動