首页/软件开发/前端开发/添加实用函数Skill/
name: add-utils-function
description: 在fe-tools中添加或修改实用函数。当用户要求添加新的实用/辅助/验证器函数时使用(例如,“新增utils函数”、“add utility function”、“新增SQL语句校验功能”),或者扩展@fe-tools/utils、@fe-tools/web-utils、@fe-tools/node-utils、@fe-tools/canvas-utils或@fe-tools/ai-utils中的现有工具。
添加实用函数
工作流程
- 根据函数范围识别目标包,默认为
packages/utils用于通用辅助函数。如果不确定,使用select-package技能。
- 环境无关、广泛有用的辅助函数 ->
packages/utils
- 仅浏览器API或DOM使用 ->
packages/web-utils
- 仅Node API(fs、process、path、http) ->
packages/node-utils
- Canvas 2D渲染或canvas数学辅助函数 ->
packages/canvas-utils
- AI/ML相关辅助函数(提示、模型实用程序) ->
packages/ai-utils
- 搜索现有模块以避免重复(
rg <keyword> packages)。
- 选择最合适的模块文件(例如,
array.ts、validators.ts)或创建一个新的聚焦文件。如果创建新文件,使用create-module-file技能。
- 实现函数,使用显式类型且避免
any。
- 添加双语JSDoc(中文+英文)、参数/返回文档和至少两个示例。如果需要,使用
bilingual-jsdoc技能。
- 从包的
src/index.ts导出函数。如果需要,使用update-index-exports技能。
- 在包的
__tests__目录中添加单元测试。如果需要,使用add-tests技能。
- 建议验证命令:
TEST_API=<package> npm run test
npm run build