feat(1.17.0): 查詢一律從最強查法開始（語意→關鍵字→grep）

leo：「它一定是用最好的搜尋，如果沒有才 fallback，但那不是你要指定的。」

事故：查 CF git 託管只用 grep→零命中→結論「沒查過/申請表沒送」＝指控 leo
沒做他早就做過的事。同一問題跑語意搜尋第一筆就命中（0.858），
帶出三元組「Artifacts >> 若提供 git 倉庫則可取代 >> Gitea」，leo 15 天前就記了。

根因不是關鍵字選錯，是用了三種查詢裡最弱的那種。
grep 要求先猜對詞；語意搜尋不需要。

- subagent 注入改分級查法（語意/關鍵字/grep）
- wiki-first-search：grep 零命中不再靜默退出（那正是最該用語意的時刻）；
  有命中也明說「最弱查法、搜尋詞是猜的，請補語意搜尋」

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

template/.claude/hooks/wiki-first-search.sh

@@ -69,7 +69,24 @@ esac
 
 # grep wiki（不分大小寫、含行號），最多 12 行避免洗版
 HITS=$(grep -rin --include="*.md" -- "$QUERY" "$WIKI_DIR" 2>/dev/null | head -12 || true)
-[ -z "$HITS" ] && exit 0
+
+# 🔴 grep 零命中時**不能靜默退出**——那正是今天失敗的模式（2026-07-21）：
+#    grep 查不到 → 以為 wiki 沒記載 → 結論「這件事沒查過」。
+#    但 grep 只認字面，查不到往往只代表「沒猜中用詞」。
+#    → 零命中反而是**最該改用語意搜尋**的時刻，必須出聲。
+if [ -z "$HITS" ]; then
+  echo "════════════════════════════════════════════════"
+  printf '🔍 grep 在 wiki 找不到「%s」——但這**不代表沒記載**\n' "$QUERY"
+  echo "════════════════════════════════════════════════"
+  echo "grep 只認字面，查不到通常只是「沒猜中用詞」。**改用語意搜尋再確認一次**："
+  echo "   kbdb_search(q=\"<用一句話描述你要找什麼>\", mode=\"semantic\")"
+  echo "   不知道該查哪個庫 → kbdb_get_map()｜要沿關係展開 → kbdb_graph_neighbors()"
+  echo ""
+  echo "實例：查「CF 上的 git 託管」時 grep 全零命中，語意搜尋第一筆就命中"
+  echo "（Cloudflare Artifacts >> 若提供 git 倉庫則可取代 >> Gitea，負責人 15 天前就記了）。"
+  echo ""
+  exit 0
+fi
 
 COUNT=$(printf '%s\n' "$HITS" | wc -l | tr -d ' ')
 
@@ -84,5 +101,12 @@ echo "   • 看到「不可動／待廢除／進行中」→ 先讀它的**解
 echo "     那是當時狀態不是永久禁令；條件已滿足就是可動。"
 echo "   • wiki 沒答案才值得翻原文——翻完若得到新結論，**回頭更新 wiki**。"
 echo ""
+echo "🔎 以上是 **grep（最弱的查法）** 的結果，只認字面，且搜尋詞是從你的指令**猜**出來的"
+echo "   （很可能太籠統而命中一堆無關的，同時漏掉真正的主題詞）。"
+echo "   **重要判斷一律補一次語意搜尋**——它不需要你猜對用詞："
+echo "      kbdb_search(q=\"<一句話描述你要找什麼>\", mode=\"semantic\")"
+echo "   實例：查「CF 的 git 託管」時 grep 猜到的詞是 cloudflare → 命中 12 處全無關、"
+echo "   真正的答案（Artifacts）一筆沒撈到；語意搜尋第一筆就命中。"
+echo ""
 
 exit 0