~1 小時 · 全員適用 · Hands-on
← → 或滑動切換
讓每位同事知道：遇到什麼情境、該用哪個 skill，
從今天開始就能幫知識庫變好。
不需要技術背景，會用 Claude Code 就行。
知識庫
越轉越好
詳細步驟見 github.com/zeabur/zeabur-rag#skills
Step 1：安裝 plugin
claude plugin marketplace add zeabur/zeabur-rag
claude plugin install zeabur-rag@zeabur-ragStep 2：設定連線
/zeabur-rag-setup填入以下連線資訊：
| 變數 | 值 |
|---|---|
| URL | https://kb.zeabur.com |
| API Key | rak_e132e5a744f35cc1ab3014c697061baa550705783fcc1a0c3dddc276830d3415 |
驗證：跑 /zeabur-rag-search hello，有回傳結果就代表成功。
| Source | 說明 |
|---|---|
| docs | Zeabur 官方文件 |
| forum | 論壇技術問答 |
| zebra-manual | 內部維運手冊 |
| blog | 部落格文章 |
| changelog | 更新日誌 |
| skills | Skill 文件本身 |
| learned | 使用者貢獻（就是你！） |
知識庫不是靜態的 — 每個人都能讓它變好。
/zeabur-rag-search 怎麼設定 custom domain也可以直接用自然語言問 Claude，它會自動搜知識庫。
每筆結果旁會顯示 score，數字越高越相關：
| Score | 意思 |
|---|---|
| > 0.035 | 高度相關 — 關鍵字和語意都命中 |
| 0.015–0.035 | 部分相關，需要自己判斷 |
| < 0.015 | 可能沒有相關知識 — 這是一個 gap |
搜完後可以繼續用中文追問，Claude 會保留搜到的內容作為上下文。
用自己最近遇過的一個真實問題搜看看。
/zeabur-rag-search <你的問題>觀察：
記下你搜到的問題，等等情境 3 會用到。
/zeabur-rag-learnSkill 會引導你填寫標題、內容、tags。
| 太模糊 | 好的 |
|---|---|
| 「可以設定 health check」 | 「Zeabur 預設每 10 秒送 GET /。要改路徑的話，設 ZEABUR_HEALTH_CHECK_PATH=/health。」 |
不用擔心寫錯 — admin 會 review，不對的會被退回。
貢獻一條你知道但知識庫裡沒有的知識。
/zeabur-rag-search <你的主題>/zeabur-rag-learn每人至少貢獻 1 條。
/zeabur-rag-report| Type | 什麼時候用 |
|---|---|
outdated | 以前是對的，但平台已經改了 |
incorrect | 現在就是錯的 |
missing | 這個主題完全沒有被收錄 |
你不需要知道正確答案也能 report。
「這個 UI 按鈕已經不存在了」就是有用的回報。
回頭看情境 1 的搜尋結果，找一個值得回報的問題。
/zeabur-rag-report每人至少回報 1 個。
/zeabur-rag-triage看有多少待處理項目：
| 類別 | 說明 |
|---|---|
| Open Reports | 使用者回報的問題 |
| Unverified Learned | 貢獻的知識還沒驗證 |
| Low Similarity Signals | 搜不到好結果的 query |
| Negative Feedback | 使用者給了負評的搜尋 |
需要 admin scope
/zeabur-rag-curate進入互動式維護流程，一個一個 review：
/zeabur-rag-learn 補上處理過程中可能會用到：
| Skill | 用途 |
|---|---|
| /zeabur-rag-inspect | 看某個 chunk 的完整內容、report 記錄、編輯歷史 |
| /zeabur-rag-edit | 直接修改 chunk 的標題、內容、tags、visibility |
需要 admin scope
講師示範處理剛才練習中產生的 report 和 learned chunk。
/zeabur-rag-triage — 看待處理清單/zeabur-rag-curate — 逐一 review/zeabur-rag-inspect — 檢查 chunk 細節/zeabur-rag-edit — 修正內容| 情境 | Skill | 權限 |
|---|---|---|
| 遇到問題，先搜 | /zeabur-rag-search | 所有人 |
| 解決後寫回知識 | /zeabur-rag-learn | 所有人 |
| 搜到錯的或缺的 | /zeabur-rag-report | 所有人 |
| 看 chunk 詳情 | /zeabur-rag-inspect | Admin |
| 直接改 chunk | /zeabur-rag-edit | Admin |
| 看待處理清單 | /zeabur-rag-triage | Admin |
| 批次維護 | /zeabur-rag-curate | Admin |
1. 處理 ticket 前 → /zeabur-rag-search
2. 處理 ticket 後 → /zeabur-rag-learn（如果發現新知識）
3. 搜到怪結果 → /zeabur-rag-report
4. 每週 → /zeabur-rag-triage + /zeabur-rag-curate（admin）
/zeabur-rag-search /zeabur-rag-learn /zeabur-rag-report /zeabur-rag-triage /zeabur-rag-curate