search-first

概覽：search-first 技能

什麼是 search-first

search-first 技能是一種先研究、後撰寫程式的工作流程，會先找現成工具、函式庫與實作模式，再開始寫自訂程式碼。當你希望助理像謹慎的偵察者，而不是先猜再寫的工程師時，這個技能特別有用。

誰適合使用

如果你正在開發新功能、評估依賴套件、加入整合，或打造一個可能早就有人做過的輔助工具，就適合用 search-first 技能。當你想重用經過驗證的模式，而不是自己憑空發明一套時，它也很適合 search-first for Skill Scaffolding 這種情境。

為什麼它重要

search-first 的核心價值在於提升決策品質：它會在建議程式碼之前，先推動助理去搜尋 npm、PyPI、GitHub、網路來源，以及相關技能。這能減少重複工作、改善依賴套件的選擇，也讓「自己做 vs 採用現成方案 vs 包裝整合」這類決策更站得住腳。

如何使用 search-first 技能

安裝並觸發它

要進行 search-first install，可以用 npx skills add affaan-m/everything-claude-code --skill search-first 把技能加進來。當任務聽起來像「加上 X」、「幫我找 Y 的函式庫」，或「有沒有更好的做法」時，就可以觸發它。search-first usage 的模式，最適合你明確要求先研究、再實作的情況。

用有決策感的需求說明

弱一點的需求會說：「做一個檔案解析器。」更好的需求會說：「需要一個給 Node 18 用的 TypeScript 檔案解析器，必須支援串流、不能有 native deps、偏好 MIT license，並且我想要 3 個可採用或自建的選項和它們的取捨。」這種格式能提供足夠脈絡，讓技能好好搜尋並比較候選方案，而不是只丟出泛泛建議。

先讀對的檔案

先看 SKILL.md，再檢查 README.md、AGENTS.md、metadata.json，以及如果存在的 rules/、resources/、references/、scripts/ 資料夾。在這個 repo 裡，SKILL.md 是主要依據，所以你可以不用在一堆支援檔案裡亂找，直接快速往下做。

把工作流程當成提示詞模板

一個實用的 search-first guide 提示詞，應該包含：需求、限制、候選方案搜尋、評估標準，以及清楚的決策。範例如下：「研究 X 的現有選項，比較 3 個候選，依維護狀況、文件、授權與適配度評分，最後建議採用、延伸或自訂開發。」這種結構能幫研究代理輸出可直接使用的結果，而不是鬆散的清單。

search-first 技能 FAQ

search-first 只適合大型專案嗎？

不是。它往往在小型任務上更有價值，因為這類任務很容易默默累積技術債，例如輔助函式、UI 工具，或依賴套件選擇。越是看起來簡單的變更，越可能在你跳過研究時付出更高代價。

它和一般提示詞有什麼不同？

一般提示詞可能是在問點子；search-first skill 則是在要求一套研究流程和一個決策。這個差異很重要，因為它的輸出是要支援採用決策，而不只是回答「我可以怎麼寫」。

新手也適合嗎？

適合，只要你能描述目標和限制。新手會受益，是因為這個技能能縮小搜尋範圍，並找出你可能根本不知道要去看的現成方案。若你只想立刻拿到程式碼，而不想看取捨分析，它就沒那麼有幫助。

什麼情況下不該用？

如果任務明顯是客製化、時間非常緊迫，或只跟你的程式碼庫局部強相關、外部方案不太可能適用，就可以跳過。若你已經知道要用哪個套件或模式，直接實作通常會比完整搜尋更快。

如何改進 search-first 技能

提供會改變搜尋方向的限制

最大的品質提升，來自一開始就講清楚硬性限制：語言、執行環境、框架、授權、bundle 大小、安全規則、平台限制，以及是否允許 native dependencies。這些細節能幫技能過濾候選，而不是只浮出熱門但不可用的方案。

要求比較，不只要推薦

更好的 search-first usage 請求，會要求一份簡短候選清單，並附上推薦理由。例如：「比較 3 個函式庫，說明各自可能失敗的原因，然後選出一個適合 production 的方案和一個備案。」這樣得到的研究會比只給一個名稱更有行動性。

小心只看新穎度的偏誤

常見失敗模式，是只因為專案最新或最顯眼，就在沒有檢查維護狀況、文件品質或整合成本的情況下做選擇。你可以要求 search-first skill 一併納入導入摩擦、與生態系的相容度，以及什麼條件會讓你直接淘汰候選方案。

第一輪之後再迭代

如果第一次結果太廣，就在下一輪提示詞補上一個缺少的限制，或一個驗收測試。對 search-first for Skill Scaffolding 而言，這可能代表要加上目標語言、repo 結構，或你想重用的 scaffolding 類型。