SuperAPI AI 工具集

search-first

编程与开发

查看项目

更新于 11-07 16:06

技能介绍

search-first 是一个“先调研再编码”(Research-before-coding)的工作流技能,用于在编写自定义代码之前,先搜索已有的工具、库和实现模式,并会调用 researcher agent。它把“先找现有方案再实现”的做法系统化。

用途与触发场景

该技能适合在以下情况使用:启动一个很可能已有现成方案的新功能;添加依赖或集成;用户要求“增加 X 功能”而你正准备写代码;在创建新的工具、辅助函数或抽象层之前。

工作流

  1. 需求分析:明确需要什么功能,识别语言/框架约束。
  2. 并行搜索(由 researcher agent 执行):检索 npm/PyPI、MCP/Skills、GitHub/Web。
  3. 评估:对候选方案按功能、维护性、社区、文档、许可证、依赖等维度打分。
  4. 决策:直接采用(Adopt as-is)、扩展/封装(Extend/Wrap)、自建(Build Custom)。
  5. 实现:安装包、配置 MCP,或编写最少量的自定义代码。

决策矩阵

  • 精确匹配、维护良好、MIT/Apache 许可:直接采用,安装并使用。
  • 部分匹配、基础良好:扩展,安装并编写薄封装。
  • 多个弱匹配:组合,合并 2-3 个小包。
  • 没有合适方案:自建,但在调研基础上编写。

使用方式

快速模式(内联):在编写工具或添加功能前,依次自查——仓库中是否已有(先用 rg 检索相关模块/测试);是否是常见问题(搜索 npm/PyPI);是否已有对应 MCP(检查 ~/.claude/settings.json 并搜索);是否已有对应 skill(检查 ~/.claude/skills/);是否有 GitHub 实现/模板(在编写全新代码前,用 GitHub 代码搜索查找仍在维护的开源实现)。

完整模式(agent):对于非简单功能,启动 researcher agent:

Task(subagent_type="general-purpose", prompt=" Research existing tools for: [DESCRIPTION] Language/framework: [LANG] Constraints: [ANY]

Search: npm/PyPI, MCP servers, Claude Code skills, GitHub Return: Structured comparison with recommendation ")

按类别的搜索快捷参考

  • 开发工具:Linting → eslint、ruff、textlint、markdownlint;格式化 → prettier、black、gofmt;测试 → jest、pytest、go test;提交前检查 → husky、lint-staged、pre-commit。
  • AI/LLM 集成:Claude SDK → 用 Context7 获取最新文档;Prompt 管理 → 检查 MCP 服务器;文档处理 → unstructured、pdfplumber、mammoth。
  • 数据与 API:HTTP 客户端 → httpx(Python)、ky/got(Node);校验 → zod(TS)、pydantic(Python);数据库 → 先检查 MCP 服务器。
  • 内容与发布:Markdown 处理 → remark、unified、markdown-it;图片优化 → sharp、imagemin。

与其他环节的配合

  • 与 planner agent:planner 应在第一阶段(架构评审)之前调用 researcher,由 researcher 识别可用工具,planner 将其纳入实现计划,避免在计划中“重复造轮子”。
  • 与 architect agent:architect 在做技术栈决策、发现集成模式、查找现有参考架构时应咨询 researcher。
  • 与 iterative-retrieval 技能:结合使用可渐进式发现——第一轮广泛搜索(npm、PyPI、MCP),第二轮详细评估头部候选,第三轮测试与项目约束的兼容性。

示例

  • “添加死链检查”:需要检查 Markdown 文件中的失效链接;搜索 npm “markdown dead link checker”;找到 textlint-rule-no-dead-link(评分 9/10);直接采用:npm install textlint-rule-no-dead-link;结果零自定义代码,使用经过实践检验的方案。
  • “添加 HTTP 客户端封装”:需要带重试和超时处理的健壮 HTTP 客户端;搜索 npm “http client retry”、PyPI “httpx retry”;找到 got(Node,带重试插件)和 httpx(Python,内置重试);直接采用:使用 got/httpx 并配置重试;结果零自定义代码,使用生产验证过的库。
  • “添加配置文件检查器”:需要按 schema 校验项目配置文件;搜索 npm “config linter schema”、“json schema validator cli”;找到 ajv-cli(评分 8/10);采用并扩展:安装 ajv-cli,编写项目专用 schema;结果 1 个包 + 1 个 schema 文件,无自定义校验逻辑。

反模式

直接跳到编码:未检查是否已有现成工具就编写工具;忽略 MCP:未检查 MCP 服务器是否已提供该能力;过度定制:对库封装过重,以致失去其优势;依赖膨胀:为一个小功能安装庞大的包。