Communitygithub.com

shimo4228/search-first

Claude Code 技能:強制代理在編寫新程式碼之前先研究現有解決方案 — 減少重複造輪子

search-first 是什麼?

這個技能旨在訓練 AI 代理(如 Claude Code、Cursor 等開發者工具中的代理)遵守「先研究再寫程式碼」的紀律。其核心價值在於減少不必要的重複開發,讓代理在動手實作新功能、工具或整合前,優先搜尋程式碼庫、套件註冊表、MCP 伺服器、已安裝的技能/工具以及開源專案中是否已存在可用的解決方案。技能明確定義了三個步驟:首先,代理必須以使用者可見的文字明確闡述需求;其次,依照設定的優先順序進行系統性搜尋;最後,記錄一個證據驅動的「裁決」,包含採用(Adopt)、擴充(Extend)、組合(Compose)或自行建立(Build)四種明確結論。這個技能特別強調「沒有裁決的搜尋是不完整的」,要求代理在每次搜尋後都留下可稽核的決策記錄,即使使用者要求跳過研究,也必須記錄該決定。它支援快速模式(內聯執行)和完整模式(委派給子代理進行深度研究),並明確列出常見的錯誤模式,幫助代理避免常見陷阱。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/search-first

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

/search-first — 先研究,再寫程式碼

在編寫新功能、工具、整合或選擇函式庫之前,先搜尋現有解決方案。最好的程式碼是你不需要寫的程式碼。

此技能關乎紀律,而非機制。搜尋的 方式(例如平行子代理、即時文件查詢、套件註冊表查詢)屬於你的代理框架,且會不斷變化。此技能鎖定的是那些超越變化的部分:搜尋前先闡明需求,按來源優先順序搜尋,並以記錄裁決作結。 先掌握紀律,再委派機制。

步驟 0 — 闡明需求(必做,且為使用者可見的文字)

在進行任何工具呼叫或子代理之前,先以 純助理文字(而非藏在工具引數內)寫 2–3 句話,說明:

  • 需要什麼功能 — 具體描述,而非「支援 X」
  • 實作將使用的語言 / 框架
  • 限制條件 — 現有依賴、效能限制、授權要求

原因:這能將搜尋查詢外部化,讓使用者在代理花費精力之前就能夠修正方向,並留下可稽核的記錄。子代理呼叫如果其 args 包含需求,並不滿足此步驟 — 使用者讀的是聊天文字,而非工具引數。先以文字形式發出闡明,再呼叫參數可能與之相同的工具。

步驟 1 — 按來源優先順序搜尋

依序檢查以下來源;找到強匹配時可提前停止:

  1. 此倉庫 — 使用 rg/grep 搜尋相關模組和測試。該功能可能已經存在於此。
  2. 套件註冊表 — 與所涉語言對應的 npm / PyPI / crates / Go 模組。
  3. MCP 伺服器 — 先檢查已配置的伺服器,再查詢註冊表。該功能可能已經被整合進來。
  4. 已安裝的技能 / 代理 / 工具 — 你的框架可能已包含該功能。
  5. 已維護的開源軟體 / 模板 — 在編寫全新程式碼之前,先透過程式碼搜尋 GitHub。

在決策時查詢即時文件(例如使用 context7 或註冊表本身),而非依賴記憶中的套件事實 — 套件推薦會過時。

步驟 2 — 做出決定,並記錄裁決

整體評估候選方案:功能契合度、維護狀況(最後一次提交時間、議題回應速度)、社群、文件、授權、依賴規模。以文字描述其優缺點。請勿使用數字評分(8/10)、字母等級或加權評分表 — 這些會製造虛假的精確度;一個有證據支持的裁決才是誠實的輸出。

裁決時機行動
採用 (Adopt)完全匹配、維護良好、授權寬鬆直接安裝使用
擴充 (Extend)良好的基礎,部分符合安裝 + 輕量包裝 / 設定
組合 (Compose)幾個弱匹配組合 2–3 個小型套件
自行建立 (Build)無適合方案自行編寫 — 但需參考搜尋結果

每次搜尋流程結束時必須有一行可識別的裁決 — 這一行就是交付成果:

Verdict: <Adopt|Extend|Compose|Build> — <套件名稱或

相關技能