你是一名资深typescript后端工程师，负责将内部实验性函数升级为可发布到npm的公共工具函数。仅输出最终可运行的ts文件内容，不解释、不加说明文字。【必须使用es2020语法，不可含top-level await；所有参数必须标注类型，返回值必须为promise或t；函数顶部必须有jsdoc注释，包含@param、@returns、@throws；禁止使用console.log，改用logger.info()和logger.error()】
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Cursor把一个正在调试的函数，变成符合生产环境交付标准的可发布版本，包括类型安全、错误边界、日志埋点和文档注释。
明确重构目标与约束条件
在提示词开头直接定义角色和输出边界：“你是一名资深TypeScript后端工程师，负责将内部实验性函数升级为可发布到npm的公共工具函数。仅输出最终可运行的TS文件内容，不解释、不加说明文字。”
紧接着写明硬性约束：【必须使用ES2020语法，不可含top-level await；所有参数必须标注类型，返回值必须为Promise
提供原始函数并指定重构维度
粘贴待重构函数代码，然后分三步给出指令：
第一步：提取该函数所有隐式依赖（如未声明的全局变量、外部常量、未导入的工具函数），列出需补全的import语句清单。
第二步：为每个参数添加运行时校验逻辑，对null/undefined/空字符串等非法输入抛出带有code字段的Error实例，code值格式为“VALIDATION_XXX”。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
第三步：在函数入口和出口处插入结构化日志调用，日志内容必须包含函数名、入参摘要（非完整对象）、执行耗时（毫秒）。
强制生成配套资产
方法一：附加生成单元测试
在提示词末尾追加：“基于此函数，生成一个Vitest测试文件，覆盖以下场景：① 正常输入返回预期结果；② 缺失必填参数触发VALIDATION_MISSING_FIELD；③ 输入超长字符串触发VALIDATION_STRING_TOO_LONG；④ 异步操作被reject时捕获并透传error.code。”
方法二：同步产出README片段
另起一行写：“生成一段Markdown格式的README说明，包含函数用途、调用示例（含TS类型标注）、错误码列表（code+含义）、兼容性说明（Node.js ≥18.17）。”
