Claude Code Cloud Routines：outcomes 配置讓文章推到 feature branch 的除錯記錄
Cloud routine 的 outcomes 配置會建立 feature branch，導致 agent 在 branch 上作業並推送，文章沒進 main。修法是移除 outcomes 加上 skill 裡補 git checkout main 雙保險，但過程中還撞上 list API pagination 的 server-side bug。
tech
518 篇文章問「我想找入門的ai課程」卻回 0 筆？RAG 中文分詞與資料鏈路脫節除錯實戰
在 Ask AI 輸入「我想找入門的ai課程」顯示搜尋文章 0 筆並觸發拒答，底部的延伸閱讀卻精準推薦相關文章。第一輪修正中文斷詞、LIKE fallback 與 Vectorize 資料鏈路；第二輪再補漢字＋數字短詞、文章 metadata 檢索，以及只在 Validation／Critic 通過後顯示來源。
搜尋只回 10 筆的解法：Cloudflare D1 FTS5 與 Hybrid Search 中文召回實戰
查「認證」只有 10 筆，149 篇裡 41 篇命中被漏掉：D1 FTS5 的 unicode61 對 2 字中文失效、本地 chunks_fts 0 筆、加上硬上限 12 的共同結果；用 LIKE fallback 與拆字 OR 先把召回補回來，再補 trigram 重建與分頁。
手機 Chrome 登入後跳回登入頁：HTTP 入口沒有轉 HTTPS 的踩坑記錄
手機 Chrome 登入後跳回登入頁，不一定是 OAuth 或前端狀態壞掉；這次根因是 app-dev.daodao.so 的 HTTP 入口沒有 301 到 HTTPS，導致 /auth/me 以 http origin 發出時沒有帶 auth_token。
LLM agent 的 tool description 決定它怎麼選 tool：三個踩坑修法
把 tool description 從軟建議改成硬規則（白名單 + 後果說明），LLM 亂選 tool 的問題消失了；另外加 skip_signal=True 修掉 vector store 雙重 indexing。
本機開發 AI Backend API 永遠回空資料：Cookie Domain 隔離問題
主後端跑在遠端 HTTPS，auth_token cookie 的 domain 是遠端，瀏覽器不會把它送到本機 AI backend，導致 API 認為未登入。
Claude Code Troubleshooting 索引：第 33-35 篇安裝、執行期與設定診斷
原 Claude Code 除錯合集已拆分為第 33-35 篇：安裝與登入、執行期問題、設定診斷。本頁是三篇的索引。
Claude Code Global Skills 新 Session 找不到？釐清 Skill Discovery 機制與排查方法
Global skills 放在 ~/.claude/skills/ 但新 session 或 Desktop App 看不到？問題通常不是檔案不存在，而是 skill 描述沒被載入 context。本文釐清 CLI vs Desktop App 的差異、settings.json 的角色，以及最穩定的解法。
MCP Tool 回傳 1M 字元：search_local_jobs 的 token 爆炸問題
MCP tool 回傳 description 欄位導致 1033 筆職缺超過 token 上限，改成預設不回傳 description 並加上分頁就解決了。
Astro + Cloudflare Workers：Native Module 在 Prerender Route 也會讓 Build 炸掉
即使 route 有 prerender = true，Cloudflare Workers 的 Rollup 還是會嘗試打包 native module，導致 build 失敗。把需要 native module 的工作移到 postbuild script 才是正解。
Astro Scoped CSS 不套用到 MDX 渲染的內容
Astro scoped CSS 會加 scope hash，但 <Content /> 渲染的 MDX 元素沒有這個 hash，導致所有 prose 樣式失效。
Cloudflare Workers 綁定自訂網域的正確寫法
wrangler.jsonc 的 routes 用 custom_domain: true，pattern 只填 hostname，不加 /*