SuperAPI AI 工具集

recommend

编程与开发

查看项目

更新于 10-15 14:31

技能介绍

用途

该技能用于分析用户的代码或需求描述,推荐最合适的 es-toolkit 函数。当用户询问应使用哪个 es-toolkit 函数、需要帮助查找函数,或提供代码片段希望分析时,即可使用。

主要能力

  • 解析用户输入($ARGUMENTS),识别想要执行的操作、涉及的数据类型(数组、对象、字符串等),并判断是否需要 lodash 迁移帮助(若是则建议使用 /es-toolkit:migrate)。
  • 在用户项目实际安装的 es-toolkit 包中查找候选函数,通过运行时入口点搜索,输出对已安装版本具有权威性。
  • 读取已安装包的真实声明文件,获取准确的函数签名、JSDoc 和示例,并在可用时检查实现,尤其是变更和错误行为。
  • 按可预测模式构造官方文档 URL,而非直接抓取。
  • 按固定结构给出推荐,包括函数名与分类、导入路径、文档链接、功能说明、代码示例以及适配用户需求的原因。
  • 推荐多个函数时提供对比表(函数、输入类型、行为、性能、返回类型),并附“何时选择哪个”的决策标准。
  • 若无匹配函数,会明确说明并建议现代 JS 替代方案;对于 lodash 兼容替换,引导用户使用 /es-toolkit:migrate 技能。

使用方式

技能接收 $ARGUMENTS 作为输入,即用户需求的描述或待分析的代码片段。工作流程包括:理解需求、在已安装包中查找候选、读取真实声明、构造官方文档 URL、按结构响应。查找候选时需从依赖 es-toolkit 的包运行命令;在 monorepo 中通常是工作区包而非仓库根目录;若项目使用 Yarn Plug'n'Play,则使用 yarn node 代替 node。若 es-toolkit 无法解析,会说明无法验证已安装版本,且不会编造函数名。当当前项目就是 es-toolkit 源码仓库本身时,直接搜索 src/ 及其测试文件。

适用场景

  • 用户不确定该用哪个 es-toolkit 函数。
  • 用户需要帮助查找特定功能的函数。
  • 用户提供代码片段希望分析并推荐函数。
  • 用户可能需要从 lodash 迁移。

限制

  • 推荐必须基于用户项目实际安装的 es-toolkit 版本,不能依赖训练数据。
  • 该技能可能作为独立目录安装,因此不能假设 es-toolkit 仓库或同级文档目录可用。
  • es-toolkit/types 仅为类型,无法在运行时导入,需检查其声明文件。
  • 若不确定文档页面是否存在,应省略页面链接而非猜测。
  • 若 es-toolkit 无法解析,需说明无法验证已安装版本,不得编造函数名。