指令用途

/research 是一個小型、模型觸發的 skill。它會啟動一個背景代理，針對一個問題對一手來源進行調查 —— 官方文件、原始碼、規格、第一方 API —— 然後在 repo 存放這類筆記的地方留下單一附引用的 Markdown 檔。

這是把閱讀的苦力活委派出去：你繼續做你的事，它在背景讀，最後你拿到一份文件來進行追問、規劃或設計。

因為它是模型觸發，代理能在它遇到需要調查的問題時自動伸手呼叫它，而不必你記得切換 context。

運作流程

1. 界定問題：明確要調查的問題為何（一個可回答的問題，不是模糊主題）。
2. 啟動背景代理：代理在背景對一手來源進行調查。
3. 引用把關：只引用高信任度來源 —— 官方文件、原始碼、規格、第一方 API。駁回部落格、論壇、二手轉述。
4. 捕獲發現：把結論寫成單一 Markdown 檔，每個主張都附上來源連結。
5. 回報路徑：告知檔案位置，供你進一步追問、規劃或設計。

實戰對話範例

範例一：自動觸發（模型觸發）

• You:

  我想用 PostgreSQL 的 partial index 來加速這個 query，但不確定語法跟限制。

• AI:

  這需要查證一手來源。我啟動 /research 背景代理去查 PostgreSQL 官方文件與原始碼關於 partial index 的語法與限制。

  你可以先繼續其他部分，完成後我會把發現寫到 docs/research/postgres-partial-index.md 並附上官方文件連結。

範例二：顯式呼叫

• You:

  /research React 19 的 use() hook 與 useEffect 有什麼本質差異？

• AI:

  啟動背景調查。來源鎖定：

  • React 官方文件（react.dev）
  • React 原始碼（github.com/facebook/react）
  • React RFC 與 release notes

  完成後寫入 docs/research/react-use-vs-useeffect.md，每個結論附引用。

什麼是「一手來源」

本 skill 對來源嚴格把關。可用的：

• 官方文件（react.dev、docs.python.org、廠商 docs）
• 原始碼（GitHub repo 上的實際 code）
• 規格 / RFC（官方 spec、語言規格）
• 第一方 API（廠商提供的 API reference）

會被駁回的：

• 部落格文章（即便是知名作者）
• Stack Overflow 答案
• 論壇討論
• 二手轉述、摘要文章

理由：一手來源是權威的；二手來源是可能過時或誤讀的快取。要查證就查源頭。

何時應該使用

• 需要查證 API 行為、語法、限制：不確定就查官方，別猜。
• 要決定技術選型需要的事實：例如「X 函式庫支援 Y 嗎？」
• 想委派閱讀苦力：你繼續做事，代理在背景讀。
• /wayfinder 的 research tickets：wayfinder 會為每張 research ticket 啟動 /research 子代理平行燒掉它。

何時不應該使用

• 能用 --help 或一份 config 回答的問題：直接查，不必啟動代理。
• 主觀意見、取捨討論：這是一手事實調查，不是觀點收集 —— 用 /grilling 來逼問取捨。
• 你自己已經很熟的領域：直接回答，不必研究。

與其他技能的關係

/research 是一個隨時可用的獨立技能，也是 /wayfinder 的要角 —— wayfinder 的 research ticket 是 AFK 共享阻塞項，charting session 會為每張 research ticket 啟動 /research 子代理平行燒掉它，把發現捕獲在 research/<name> 拋棄式分支上。不確定該用哪個 skill 時，用 /ask-matt 來路由。