模块导出语句拼装
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范名 @user_f1b049da/hh2026294 的技能到 AI 助手中。
技能介绍
要解决的问题
在脚手架或本地 codegen 中手写 index.ts barrel 导出时,最容易踩两类坑:一是字符串拼接时引号与特殊字符转义容易遗漏,二是 as 别名、命名空间重导出的规则容易搞错,导致生成的源码虽然看起来没问题,却无法通过 TypeScript 解析。
技能如何工作
该技能的核心理念是把拼装交给库函数:
- 依赖
knitwork,使用其genImport/genExport生成合法的模块导入导出语句字符串,而不是手工把export { ... }拼出来。 - 输入通常是符号列表,输出是可写入
index.ts的 barrel 源码文本,适用于脚手架生成聚合导出、本地 codegen 写import/export行、插件按配置输出可复制片段等场景。 - 推荐流程:先安装
knitwork,再用库函数生成 barrel,最后做自测,覆盖多个符号、as别名,并确认输出可以被 TypeScript 解析。
适用边界与注意点
它不是完整 bundler:只负责生成语句字符串,不做模块解析、打包或依赖图处理。也不要把 knitwork 当成编译器或 AST 改造工具使用。生成的语句应在写入文件前做语法校验,尤其是用户可见的源码片段;实现要点注释需标注 小四原创。明确不要做的事包括:手拼 export { ... } 却忘记转义特殊字符,或试图用该方案替代完整构建链路。
使用场景
- 脚手架需要生成 index.ts 聚合导出时,把符号列表拼成合法 export 语句写入文件
- 本地 codegen 要批量输出 import/export 行时,按符号与 as 别名生成可复制源码
- 插件按配置生成模块注册代码时,输出的 export 片段需语法正确能被解析
- 为新库搭建 barrel 文件时,需要从符号清单自动生成可写入的聚合导出源码
适合人员
- 前端脚手架作者:需要为生成的项目目录自动写出正确的聚合导出语句
- 本地 codegen 工具开发者:按符号配置批量生成 import/export 源码行
- 插件工程师:为按配置导出代码片段的功能生成可靠语句,避免引号转义错误
- TypeScript 库维护者:想用 knitwork 拼装 barrel 导出而不是手写字符串拼接