⚡

添加实用函数技能Skill add-utils-function

此技能用于在fe-tools中添加或修改实用函数，涵盖从需求分析到代码实现的完整工作流程，包括包选择、避免重复、类型安全、文档编写、测试和验证。关键词：实用函数、前端开发、代码添加、JSDoc、单元测试。

前端开发 0 次安装 0 次浏览 更新于 3/18/2026

name: add-utils-function description: 在fe-tools中添加或修改实用函数。当用户请求添加新的实用/助手/验证器函数（例如，“新增utils函数”、“add utility function”、“新增SQL语句校验功能”）或扩展@fe-tools/utils、@fe-tools/web-utils或@fe-tools/node-utils中的现有实用函数时使用。

添加实用函数

工作流程

  1. 根据环境需求识别目标包：
    • 环境无关的逻辑 -> packages/utils
    • 仅限浏览器的API -> packages/web-utils
    • 仅限Node的API -> packages/node-utils
  2. 搜索现有模块以避免重复（使用rg <keyword> packages）。
  3. 选择最合适的模块文件（例如，array.ts、validators.ts）或创建一个新的聚焦文件。
  4. 实现函数，使用明确的类型，不使用any。
  5. 添加双语JSDoc（中文 + 英文）、参数/返回文档，至少两个示例。如果需要，使用bilingual-jsdoc技能。
  6. 从包src/index.ts导出函数。
  7. 在包__tests__目录中添加单元测试。如果需要，使用add-tests技能。
  8. 建议验证命令：
    • TEST_API=<package> npm run test
    • npm run build