/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) | 没有合适的方案 | 编写自定义代码——但基于已发现的内容做出明智决策 |
每次搜索都以一句可识别的裁决行结束——这一行是可交付成果:
裁决: <采纳|扩展|组合|构建> — <包名或