用途
该技能用于分析用户的代码或需求描述,推荐最合适的 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 无法解析,需说明无法验证已安装版本,不得编造函数名。