homunculus-code 0.1.0

package/examples/reference/evolved-skills/api-system-diagnosis.md

@@ -0,0 +1,234 @@
+# Skill: API System Diagnosis Workflow
+
+**Version:** 1.1
+**Evolved from:** 9 instincts (api-endpoint-code-change-verification-cycle, api-filter-mismatch-diagnosis-cycle, api-parameter-ignored-diagnosis-cycle, api-then-user-observation-verification, api-first-ui-bug-diagnosis-workflow, multi-layer-data-diagnosis-workflow, grep-first-cross-layer-api-diagnosis, cross-layer-decision-verification-pattern, cross-system-state-sync-verification-workflow)
+**Confidence threshold:** 0.75–0.85
+**Created:** 2026-03-19
+**Use when:** UI 顯示異常、API 返回非預期值、參數被忽略、Filter 不符、跨層 bug、服務未載入新代碼
+
+## 目的
+
+系統化診斷 API / 後端 / 前端 跨層問題的通用工作流。適用於：UI 顯示異常、API 返回非預期結果、參數被忽略、Filter 不符、服務未載入新代碼等場景。
+
+---
+
+## 核心原則
+
+1. **Grep 優先**：問題在哪層？先搜尋代碼，再實驗。
+2. **由內而外**：API 層 → 業務邏輯層 → 前端渲染層，逐層確認。
+3. **縮小範圍**：每層用 curl/jq 確認數據後，再進入下一層。
+4. **服務重啟後才驗證**：Node.js 修改 server.js 後，舊進程仍在跑，必須重啟。
+
+---
+
+## Phase 1：根因定位（Grep 優先）
+
+### 1a. 定位處理函數
+
+```bash
+# 找 API 端點處理器
+grep -n "app\.\(get\|post\|put\|delete\).*endpoint" server.js
+
+# 找 filter / selector 邏輯
+grep -n "filter\|select\|map\|find" src/component.js
+
+# 追蹤跨文件調用鏈
+grep -rn "functionName" .
+```
+
+### 1b. 識別問題層
+
+| 症狀 | 懷疑層 | 驗證方式 |
+|------|--------|---------|
+| UI 顯示異常 | 前端 render | curl API 比對 JSON |
+| Filter 結果不符 | Filter 邏輯 | 印出 filter 條件 + raw data |
+| 參數未生效 | 後端讀取 | curl 帶 body 測試 |
+| 功能在舊進程 | 服務未重啟 | 重啟後 re-test |
+
+---
+
+## Phase 2：層級驗證流程
+
+### 2a. API 層（最先驗證）
+
+```bash
+# 驗證數據源是否乾淨
+curl -s http://localhost:3000/api/endpoint | jq '{field1, field2, count: (.items | length)}'
+
+# 確認欄位值格式（注意 "done" vs "completed" 這類 typo）
+curl -s http://localhost:3000/api/tasks | jq '.[0] | keys'
+```
+
+**紅旗**：
+- 欄位值格式不符預期（"done" vs "completed"）
+- 陣列長度不符
+- 歷史污染數據存在（舊 prefix 如 `qrr*`）
+
+### 2b. 業務邏輯層（參數處理）
+
+當 API 參數沒有被正確應用時：
+
+```bash
+# 1. 確認前端確實傳了參數
+grep -n "fetch\|axios\|curl" src/api-client.js | grep endpoint
+
+# 2. 確認後端讀取了參數
+grep -n "body\.\|req\.body\|query\." server.js | grep param_name
+
+# 3. 確認後端寫入了 state
+grep -n "state\[.param_name.\]\|\.param_name =" server.js
+```
+
+**常見 bug**：
+- `body.param` 讀對了，但 `state.param` 沒有寫入
+- filter 條件用了硬編碼值（`=== "pending"`），沒有讀 config
+
+### 2c. 前端渲染層（UI 異常）
+
+```bash
+# 定位 filter/hide/skip 邏輯
+grep -n "filter\|display.*none\|hidden\|skip" static/app.js
+
+# 確認 selector 對應的 class/id
+grep -n "querySelector\|getElementById\|\.class" static/app.js
+```
+
+**當 API 數據正確但 UI 仍顯示異常**（常見 field name mismatch）：
+
+```bash
+# Step 1：確認 API 返回的欄位名稱與值
+curl -s http://localhost:3000/api/endpoint | jq '.[0] | {status, type, done}'
+
+# Step 2：grep 前端 filter 比較用的字串，找命名不一致
+grep -n '"done"\|"completed"\|"finished"\|===.*status\|\.status' static/app.js
+
+# Step 3：確認 filter 邏輯用的欄位名是否與 API 一致
+# 例：API 返回 status: "done"，但前端 filter 判斷 status === "completed" → mismatch
+```
+
+**常見 mismatch 類型**：
+- 值不一致：API `"done"` vs 前端 filter `"completed"`
+- 欄位名不一致：API `forge_cost` vs 前端讀取 `forgeCost`（camelCase 轉換遺漏）
+- 型別不一致：API 返回數字 `0` vs 前端比較字串 `"0"`
+
+---
+
+## Phase 3：服務重啟驗證循環（Node.js）
+
+修改 `server.js` 後，舊進程繼續執行舊代碼。
+
+```bash
+# 步驟 1：找目標進程
+ps aux | grep "node.*server"
+
+# 步驟 2：重啟
+kill <PID> && sleep 1 && cd ~/assistant/quest-board && node server.js &
+
+# 步驟 3：健康確認
+curl -s http://localhost:3000/health
+
+# 步驟 4：新功能驗證
+curl -s -X POST http://localhost:3000/api/new-endpoint \
+  -H "Content-Type: application/json" \
+  -d '{"key":"value"}' | jq
+```
+
+**注意**：
+- 用 grep 只殺目標進程（避免殺掉其他 Node）
+- `sleep 1` 給進程時間釋放 port
+- 先驗證 `/health`，確認服務恢復後再測新端點
+
+### 3b. 服務正常但端點仍 404（路由層診斷）
+
+/health 正常但新端點仍返回 404 時，進程問題已排除，應 grep 確認路由定義：
+
+```bash
+# 確認端點路徑（完整路徑 + HTTP method）
+grep -n "app\.\(get\|post\|put\|delete\)\s*['\"].*new-endpoint" server.js
+
+# 確認 middleware 順序（靜態 handler 是否在 route 前攔截）
+grep -n "app\.use\|express\.static\|router" server.js | head -20
+
+# 確認 body parser 已載入（POST body 讀取需要）
+grep -n "express\.json\|bodyParser" server.js
+```
+
+常見原因：
+- 路徑拼寫錯誤（`/api/test` vs `/api/tests`）
+- HTTP method 不符（GET 卻 POST）
+- 靜態檔案 handler 攔截了請求
+- body parser middleware 未載入（`req.body` 為 undefined）
+
+---
+
+## Phase 4：分層驗證決策
+
+修改涉及多層時，逐層問：「這層真的需要修改嗎？」
+
+```
+修改觸發點（API endpoint）
+    ↓
+  是否影響業務邏輯層？（State update / filter logic）
+    ↓
+  是否影響前端渲染？（HTML template / JS selector）
+    ↓
+  是否影響其他系統？（heartbeat / session-start）
+```
+
+**不要假設**多層都需要改，逐層 grep 確認後再決定。
+
+---
+
+## Phase 5：跨系統狀態同步驗證
+
+修改待辦/狀態系統後的驗證清單：
+
+```bash
+# API 層
+curl -s http://localhost:3000/api/state | jq '.tasks[] | select(.id == "TARGET_ID")'
+
+# Session context（session-start 載入）
+cat ~/assistant/sessions/*.json | jq '.summary'
+
+# Heartbeat 健康檢查
+curl -s http://localhost:3000/api/health | jq
+
+# 相依工具
+grep -rn "state\.tasks\|forge_cost" ~/assistant/scripts/
+```
+
+---
+
+## Phase 6：分層驗證策略（API → 用戶觀察）
+
+當自動化工具鏈有限制時：
+
+1. **自動化層**（優先）：curl API，驗證 JSON 數據
+2. **用戶觀察層**（補充）：在說明中加入「請確認 UI 是否顯示 X」
+
+```bash
+# 自動化驗證
+curl -s http://localhost:3000/api/forge | jq '{count: (.tasks | length), suggested: [.tasks[] | select(.status=="suggested")] | length}'
+
+# 用戶確認點（當 curl 無法覆蓋 UI 渲染時）
+echo "⚠️ 請在瀏覽器確認：ticket Y 應該不顯示在列表中"
+```
+
+---
+
+## 常見 Anti-Patterns
+
+- ❌ 直接看前端代碼猜問題，不先 curl API 驗證數據
+- ❌ 修改 server.js 後，不重啟直接測試（看到舊行為誤以為 bug 未修）
+- ❌ 假設多層都需要修改（逐層驗證才能確定）
+- ❌ Filter 結果不符時只看 UI，不比對 API raw data
+
+---
+
+## 觸發場景
+
+- UI 顯示異常：某元素應隱藏但仍出現、計數不符、區塊消失
+- API 返回非預期：欄位值錯誤、陣列長度錯、歷史污染
+- 功能修改無效：修改了代碼但行為未改變（服務重啟問題）
+- 跨層 bug：前端正確但 API 出問題，或反之
+- 多系統修改：API + heartbeat + session 同時涉及

package/examples/reference/evolved-skills/assistant-system-management.md

@@ -0,0 +1,199 @@
+# Skill: Assistant System Management
+
+**Version:** 1.2
+**Icon:** shield-1
+**Abbr:** Sys Mgmt
+**Evolved from:**
+- `dual-layer-evolution-architecture.md` (0.85)
+- `assistant-quality-system-2026.md` (0.85)
+- `todo-management-fast-path-2026.md` (0.90)
+**Evolved:** 2026-03-10 night agent (v1.0)
+**Use when:** 操作助理系統：收割/archive instinct、演化 skill、夜間 agent 任務資格判斷、Quest Board / Forge 操作、系統健康檢查
+
+## 用途
+
+管理和維護 J-Assistant 自身的系統健康。適用於：
+- 設計新的助理子系統
+- 確保操作品質
+- 管理待辦任務
+- 規劃演化策略
+
+---
+
+## 模式 1：雙層自動演化架構
+
+```
+Layer 1（每 session）: evaluate-session.js
+  observations.jsonl → 信心評估 → instinct/personal/ (conf > 0.7)
+                                 ↓
+Layer 2（每晚）: heartbeat → night agent
+  instincts → 聚合 → evolved/skills/ → eval → improve
+```
+
+### 關鍵設計原則
+1. **無人工介入**：信心 > 0.7 自動觸發，不需用戶確認
+2. **避免重複**：生成前 grep 現有 instinct 內容
+3. **持久化追蹤**：JSONL 記錄，jq 原子更新
+4. **分層設計**：日常輕量，夜間深度
+5. **Silent 操作**：Layer 1 的 instinct 捕捉和 git commit **不在主對話中輸出**，避免干擾用戶工作流
+
+### Instinct 聚合判斷標準（夜間演化）
+聚合為 skill 的條件：
+- 2+ 個 instinct 有**相似觸發條件**（keyword overlap > 50%）
+- 信心分數都 >= 0.75
+- 合併後能形成連貫的指引（不只是清單）
+
+**不聚合的情況**：主題雖相關但指引不同（保持獨立 instinct）
+
+---
+
+## 模式 2：品質門禁系統
+
+在重要操作前驗證系統品質，防止積累技術債。
+
+```bash
+# /quality-gate [commit|deploy|infra|instinct|all]
+```
+
+### 通用檢查清單
+| 檢查 | 方法 | 失敗處理 |
+|------|------|---------|
+| JSON 完整性 | `jq empty data/*.json` | ❌ 阻止 |
+| Shell 語法 | `zsh -n scripts/*.sh` | ❌ 阻止 |
+| 未提交演化 | `git diff homunculus/` | ⚠️ 提醒 |
+| Instinct 格式 | grep confidence、created | ⚠️ 提醒 |
+
+### 操作特定檢查
+- **commit**: 確認 staging 不含 credentials
+- **infra**: 確認 plist 不在 staging 中
+- **instinct**: 確認 confidence 欄位存在且 0-1
+
+### 狀態符號
+- ✅ 通過 — 繼續執行
+- ⚠️ 警告 — 可選擇繼續
+- ❌ 失敗 — 建議停止
+
+---
+
+## 模式 3：系統健康審計
+
+定期或按需掃描系統健康度。
+
+```bash
+# /harness-audit [--full|--hooks|--instincts|--skills|--heartbeat]
+```
+
+### 審計維度
+
+**Hooks 健康**
+- 所有 `.sh` 腳本語法正確（`zsh -n`）
+- 必要腳本齊全：session-start/end、evaluate-session、observe、pre-compact、suggest-compact、auto-commit、profile
+- `hook-profile-config.json` 格式正確
+- Heartbeat 最後執行 < 2h
+
+**Instinct 健康**
+- 數量趨勢（是否在增長）
+- 超過 90 天未更新的（可能過時）
+- 重複主題（名稱相似度）
+- 格式完整性（name/trigger/action/confidence/created）
+
+**Skill 健康**
+- Eval 覆蓋率（有 eval spec 的比例）
+- 最新 pass rate（目標 > 80%）
+- 超過 30 天未更新且有失敗 eval
+
+**Heartbeat 健康**
+- 最後執行時間
+- Log 大小正常
+- Checks 全部語法正確
+- Todo 積壓情況
+
+### 評分標準
+- 🟢 正常：無 ❌，最多 2 個 ⚠️
+- 🟡 注意：1+ 個 ⚠️ 但無 ❌
+- 🔴 異常：任何 ❌
+
+---
+
+## 模式 4：待辦任務快速管理
+
+**單一資料來源**：`quest-board/data/state.json` 的 `.tasks[]`
+
+### Reminder 分類
+
+| 類型 | 判斷 | 用途 |
+|------|------|------|
+| Quest | 無 `forge_cost` | 生活任務，賺 XP + Gold |
+| Forge | 有 `forge_cost` | 系統任務，花 Gold + 加 Stat |
+
+### 存取方式
+
+| 場景 | 方法 |
+|------|------|
+| Session 開始自動摘要 | session-start.js 讀 state.json 注入 |
+| 快速查詢 | `/todo` slash command |
+| 新增 Quest | `/todo add <描述>` |
+| 新增 Forge | `/todo forge <描述>` |
+| 標記完成 | `/todo done <keyword>` |
+| Night Agent 完成 | Forge: `/api/forge/complete`，Quest: `/api/quest/complete` |
+
+### Session Start 注入格式
+```
+📌 待辦任務（共 N 項，用 /todo 管理）：
+  🔴 高優先（N 項）：
+    • title — notes（前 60 字元）
+  📌 一般（N 項）：title1、title2
+```
+
+---
+
+## 模式 5：Night Agent 任務閉環
+
+### 任務資格篩選（P0 必查）
+
+⚠️ **Night Agent 只能完成符合以下條件之一的任務**：
+- `priority == "high"` — 用戶標記高優先
+- `delegate_to == "night"` — 用戶明確委派夜間執行
+
+**不符合條件的 pending 任務絕對不完成**，即使：
+- 任務標題含「研究」或看起來適合夜間執行
+- 任務有 `forge_cost`（有沒有 forge_cost 不影響資格）
+- 任務是關於系統改進的
+
+```bash
+# 查詢符合條件的任務
+curl -s http://localhost:3000/api/state | jq '
+  .tasks[]
+  | select(.status == "pending")
+  | select(.priority == "high" or .delegate_to == "night")
+  | {id, title, priority, delegate_to, forge_cost}'
+```
+
+Night Agent 執行高優先任務後，必須：
+1. 透過 server API 完成任務（觸發 forge mechanics）
+2. 記錄成果到 night-report.md
+3. 新 instinct/skill 自動 git commit
+
+```bash
+# 透過 API 完成（確保 forge mechanics 正確執行）
+# Forge 任務（有 forge_cost）
+curl -s -X POST http://localhost:3000/api/forge/complete \
+  -H "Content-Type: application/json" \
+  -d "{\"id\":\"$ID\"}"
+# Quest 任務（無 forge_cost）
+curl -s -X POST http://localhost:3000/api/quest/complete \
+  -H "Content-Type: application/json" \
+  -d "{\"id\":\"$ID\"}"
+```
+
+---
+
+## 快速參考
+
+| 操作 | 命令 |
+|------|------|
+| 品質檢查 | `/quality-gate [類型]` |
+| 系統審計 | `/harness-audit [--部分]` |
+| 查看待辦 | `/todo` |
+| 系統健康 | `/health` |
+| 查看 instinct | `/instinct-status` |

package/examples/reference/evolved-skills/development-verification-patterns.md

@@ -0,0 +1,243 @@
+# Skill: development-verification-patterns
+**Version:** 1.1
+**Icon:** cross
+**Abbr:** Dev Check
+**Evolved from:** cross-file-feature-removal-workflow, isolated-dependency-removal-verification, multi-file-syntax-prevalidation-loop, local-dev-cycle-restart-verify, api-endpoint-code-change-verification-cycle, cross-system-state-sync-verification-workflow
+**Created:** 2026-03-14
+**Use when:** 提交前驗證、多檔語法預檢、prod/test 依賴區分、服務啟動失敗診斷、重構安全性確認
+
+## 概述
+
+開發過程中三類驗證模式：
+1. **語法預檢**：改完先驗語法，再做後續步驟
+2. **功能移除清理**：跨檔案移除 + 孤立依賴檢查
+3. **服務重啟驗證**：Node/shell 服務修改後的重啟 + 端點確認
+
+---
+
+## Pattern 1：多檔案語法預檢迴圈
+
+**觸發**：修改 2+ 個相關檔案後，即將部署或重啟服務前。
+
+```bash
+# Node.js
+node -c <file>.js
+
+# Bash/Zsh
+zsh -n <file>.sh
+
+# JSON
+jq empty <file>.json
+
+# 批次預檢（改完立即跑）
+node -c server.js && node -c web/app.js && zsh -n heartbeat.sh && echo "✅ All OK"
+```
+
+**原則**：
+- 語法檢查只驗語法，不驗邏輯
+- 全部通過後才重啟或部署
+- 有錯立即修正 → 重新檢查，不跳過
+
+---
+
+## Pattern 2：跨檔案功能移除 + 孤立依賴清理
+
+**觸發**：需要完整移除跨多檔案的功能（endpoint + UI + 業務邏輯 + 依賴）。
+
+### 步驟
+1. **識別範圍**
+   ```bash
+   grep -r "feature-name" .
+   ```
+2. **分層移除**（按依賴順序）
+   - UI/表現層（HTML、CSS、前端事件）
+   - 業務邏輯層（app 程式碼）
+   - API 層（後端 endpoint）
+   - 設定層（shell script）
+3. **孤立依賴檢查**：每個被移除功能的 import/require，grep 確認是否還有其他使用者
+   ```bash
+   grep -r "module-name" . --include="*.js"   # 排除 node_modules
+   ```
+   - 只在 **production 代碼**中無引用 → 移除 production import（**test 檔不算**）
+   - Test 檔中仍有引用 → 移除 production import，並同步更新/刪除該測試
+   - Production + test 以外的代碼也有引用 → 保留 import
+   - **Production vs Test 判斷**：`src/`、`*.js`（非 `*.test.js`）= production；`tests/`、`*.test.js`、`*.spec.js` = test
+4. **語法驗證**（Pattern 1）
+5. **成果審核**
+   ```bash
+   git diff   # 確認無孤立程式碼殘留
+   ```
+
+**典型範例**（移除 weather 功能）：
+```
+Grep "weather" → 找到 index.html/app.js/server.js/refresh.sh
+移除順序：HTML chip → app.js 事件 → server.js endpoint → refresh.sh 邏輯
+Grep "https" → 確認只有 weather 用 → 移除 require('https')
+node -c server.js && zsh -n refresh.sh ✅
+git diff 確認
+```
+
+---
+
+## Pattern 3：服務重啟 + 端點驗證迴圈
+
+**觸發**：修改 Node.js/Express server.js 後（新增端點、修改邏輯），需要載入新代碼。
+
+### 步驟
+```bash
+# 1. 找現有進程
+ps aux | grep "node.*server.js" | grep -v grep
+
+# 2. 重啟（只殺目標，避免誤殺）
+kill <PID> && sleep 1 && cd ~/assistant/quest-board && node server.js &
+
+# 3. 驗證服務回復
+curl -s http://localhost:3000/status   # 或 /health
+
+# 4. 測試新端點
+curl -s -X POST http://localhost:3000/<endpoint> \
+  -H "Content-Type: application/json" \
+  -d '{"key":"value"}' | jq
+```
+
+**注意**：
+- 使用 `grep -v grep` 避免 grep 自己出現在結果中
+- `sleep 1` 確保進程完全關閉後再啟動
+- 先測健康端點，再測新功能端點
+- 後台啟動用 `&`，若有 launchctl 管理則改用 launchctl
+
+### 3b. 服務啟動失敗診斷（node -c 通過但 /health 返回 Connection refused）
+
+`node -c` 只驗語法，不驗 runtime。啟動後若 `/health` 失敗：
+
+```bash
+# 步驟 1：等幾秒再重試（race condition）
+sleep 2 && curl -s http://localhost:3000/health
+
+# 步驟 2：確認進程是否存在
+ps aux | grep "node.*server.js" | grep -v grep
+# → 進程存在但無回應：port 衝突、未完全啟動，再等
+# → 進程不存在：啟動時 crash 了
+
+# 步驟 3：前景執行看 stderr（進程不存在時）
+cd ~/assistant/quest-board && node server.js
+# 看完整錯誤訊息（不加 & 讓 stderr 顯示在 terminal）
+```
+
+**常見 runtime 失敗原因**：
+- 缺少環境變數（`process.env.X` is undefined，配合 `|| throw` 立即崩潰）
+- port 已被佔用（`EADDRINUSE :3000`）
+- `require()` 路徑錯誤（找不到模組）
+- JSON.parse 失敗（state.json 損毀）
+
+---
+
+## Pattern 4：Quest Board 系統整合驗證
+
+**觸發**：修改 server.js API、session-start.js 或 state.json 相關邏輯後。
+
+### 端對端驗證清單
+```bash
+# --- Habit API（每日習慣，ephemeral in today.habits）---
+# 完成習慣
+curl -s -X POST http://localhost:3000/api/habit/complete \
+  -H "Content-Type: application/json" \
+  -d '{"questId":"q1"}' | jq
+
+# 復原習慣
+curl -s -X POST http://localhost:3000/api/habit/undo \
+  -H "Content-Type: application/json" \
+  -d '{"questId":"q1"}' | jq
+
+# --- Quest API（持久任務，無 forge_cost）---
+# 新增任務
+curl -s -X POST http://localhost:3000/api/quest/add \
+  -H "Content-Type: application/json" \
+  -d '{"title":"test-quest"}' | jq
+
+# 完成任務
+curl -s -X POST http://localhost:3000/api/quest/complete \
+  -H "Content-Type: application/json" \
+  -d '{"id":"rN"}' | jq
+
+# 復原任務
+curl -s -X POST http://localhost:3000/api/quest/undo \
+  -H "Content-Type: application/json" \
+  -d '{"id":"rN"}' | jq
+
+# 刪除任務
+curl -s -X POST http://localhost:3000/api/quest/delete \
+  -H "Content-Type: application/json" \
+  -d '{"id":"rN"}' | jq
+
+# --- Forge API（系統升級任務，有 forge_cost）---
+# 新增 Forge
+curl -s -X POST http://localhost:3000/api/forge/add \
+  -H "Content-Type: application/json" \
+  -d '{"title":"test-forge","forge_cost":3,"stat":"int"}' | jq
+
+# 完成 Forge
+curl -s -X POST http://localhost:3000/api/forge/complete \
+  -H "Content-Type: application/json" \
+  -d '{"id":"rN"}' | jq
+
+# 驗證 state 更新
+jq '.player | {gold, xp, level, stats}' ~/assistant/quest-board/data/state.json
+```
+
+**驗證點**：
+- Habit 完成：+XP、+gold、skill XP；全完成 bonus +agi
+- Quest 完成：+XP、+gold
+- Forge 完成：-gold（forge_cost）、+stat
+- Undo：扣回 XP/gold，狀態回 pending
+- Server 重啟後 state 保持不變（持久化確認）
+
+---
+
+---
+
+## Pattern 5：AC-to-Test 自動驗證迴圈
+
+**觸發**：Forge 任務有 `[testable]` AC，需要自動化驗證。
+
+### 流程
+
+1. `/forge-dev define-ac` 時標記 `[testable]` / `[manual]`
+2. `/forge-dev gen-tests` spawn `tdd-runner` subagent：
+   - 讀 `[testable]` AC → 生成 `quest-board/tests/<id>.test.js`
+   - 跑一次確認 **RED**（全失敗）
+3. `/forge-dev start` 進入紅綠迴圈：
+   - 實作 → `node --test tests/<id>.test.js` → 修到全綠
+4. `/forge-dev review` 自動跑測試 + 手動驗證 `[manual]` AC
+
+### 與其他 Pattern 搭配
+
+```
+gen-tests（RED）→ 實作（GREEN）→ Pattern 1（語法預檢）→ Pattern 3（服務重啟）→ review
+```
+
+### 測試執行
+
+```bash
+# 單一任務測試
+node --test quest-board/tests/<id>.test.js
+
+# 所有測試（序列執行，避免 state 衝突）
+node --test --concurrency=1 quest-board/tests/*.test.js
+```
+
+**詳細 pattern 和 anti-pattern 見 `tdd-workflow` skill。**
+
+---
+
+## 選擇指引
+
+| 情境 | 使用 Pattern |
+|------|-------------|
+| 改了幾個檔案，即將重啟服務 | Pattern 1（語法預檢）|
+| 移除某個功能 | Pattern 2（跨檔案移除）|
+| 改了 server.js 想測新 endpoint | Pattern 3（服務重啟驗證）|
+| 改了 Quest Board 邏輯 | Pattern 4（整合驗證）|
+| Forge 任務有 testable AC | Pattern 5（AC-to-Test 迴圈）|
+| 移除功能後涉及服務重啟 | Pattern 2 → Pattern 1 → Pattern 3 |
+| 新功能完整流程 | Pattern 5 → Pattern 1 → Pattern 3 → Pattern 4 |