Communitygithub.com

shimo4228/search-first

Claude Code 技能:强制代理在构建前先研究现有解决方案,减少重复发明。

search-first 是什么?

这是一项专为 Claude Code(及其他 AI 代理工具链)设计的技能,旨在引导代理在编写新代码前优先搜索和评估现有解决方案。核心价值在于建立一种“纪律”而非具体机制:它要求代理在执行任何搜索或工具调用前,先以用户可读的文本明确阐述需求(功能、框架、约束),然后按源优先级(当前仓库、包注册表、MCP 服务器、已安装技能、开源模板)依次搜索。找到候选方案后,代理必须依据功能匹配度、维护活跃度、社区、文档和许可证等因素做出整体评估,并记录一个结构化的裁决(采纳/扩展/组合/构建),附带基于证据的理由。该技能支持快速模式(内联完成)和完整模式(委托给子代理),并明确处理用户要求跳过研究的情况——即使跳过,也需记录裁决并告知用户,保持决策可追溯。它特别适用于需要系统性避免重复造轮子的开发场景,显著提高代码复用率和决策透明度。

兼容平台✓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)没有合适的方案编写自定义代码——但基于已发现的内容做出明智决策

每次搜索都以一句可识别的裁决行结束——这一行是可交付成果:

裁决: <采纳|扩展|组合|构建> — <包名或

相关技能