/search-first — 先研究,再寫程式碼
在編寫新功能、工具、整合或選擇函式庫之前,先搜尋現有解決方案。最好的程式碼是你不需要寫的程式碼。
此技能關乎紀律,而非機制。搜尋的 方式(例如平行子代理、即時文件查詢、套件註冊表查詢)屬於你的代理框架,且會不斷變化。此技能鎖定的是那些超越變化的部分:搜尋前先闡明需求,按來源優先順序搜尋,並以記錄裁決作結。 先掌握紀律,再委派機制。
步驟 0 — 闡明需求(必做,且為使用者可見的文字)
在進行任何工具呼叫或子代理之前,先以 純助理文字(而非藏在工具引數內)寫 2–3 句話,說明:
- 需要什麼功能 — 具體描述,而非「支援 X」
- 實作將使用的語言 / 框架
- 限制條件 — 現有依賴、效能限制、授權要求
原因:這能將搜尋查詢外部化,讓使用者在代理花費精力之前就能夠修正方向,並留下可稽核的記錄。子代理呼叫如果其 args 包含需求,並不滿足此步驟 — 使用者讀的是聊天文字,而非工具引數。先以文字形式發出闡明,再呼叫參數可能與之相同的工具。
步驟 1 — 按來源優先順序搜尋
依序檢查以下來源;找到強匹配時可提前停止:
- 此倉庫 — 使用
rg/grep 搜尋相關模組和測試。該功能可能已經存在於此。 - 套件註冊表 — 與所涉語言對應的 npm / PyPI / crates / Go 模組。
- MCP 伺服器 — 先檢查已配置的伺服器,再查詢註冊表。該功能可能已經被整合進來。
- 已安裝的技能 / 代理 / 工具 — 你的框架可能已包含該功能。
- 已維護的開源軟體 / 模板 — 在編寫全新程式碼之前,先透過程式碼搜尋 GitHub。
在決策時查詢即時文件(例如使用 context7 或註冊表本身),而非依賴記憶中的套件事實 — 套件推薦會過時。
步驟 2 — 做出決定,並記錄裁決
整體評估候選方案:功能契合度、維護狀況(最後一次提交時間、議題回應速度)、社群、文件、授權、依賴規模。以文字描述其優缺點。請勿使用數字評分(8/10)、字母等級或加權評分表 — 這些會製造虛假的精確度;一個有證據支持的裁決才是誠實的輸出。
| 裁決 | 時機 | 行動 |
|---|---|---|
| 採用 (Adopt) | 完全匹配、維護良好、授權寬鬆 | 直接安裝使用 |
| 擴充 (Extend) | 良好的基礎,部分符合 | 安裝 + 輕量包裝 / 設定 |
| 組合 (Compose) | 幾個弱匹配 | 組合 2–3 個小型套件 |
| 自行建立 (Build) | 無適合方案 | 自行編寫 — 但需參考搜尋結果 |
每次搜尋流程結束時必須有一行可識別的裁決 — 這一行就是交付成果:
Verdict: <Adopt|Extend|Compose|Build> — <套件名稱或