用途:基于当前技能目录下 scripts/ 的脱敏参考工程,创建或补齐 Node.js + TypeScript 脚本项目骨架,适合快速落地命令行脚本、批处理脚本或文件处理流水线。
主要能力:生成与参考工程一致的基础目录结构(src/constants、src/steps、src/typings、src/utils 与 test/);保留环境参数读取、步骤编排、文件读写、日志输出、基础测试和代码检查配置;保留 type: "module"、main: "src/main.ts" 及 #src/、#steps/、#utils/、#constants/ 导入映射;保留 tsconfig 的 Node.js ESM 与严格模式配置。
使用方式:先确认项目名称(英文短横线命名)、目标目录、脚本用途、必需环境变量(默认 INPUT_FILE、OUTPUT_FILE)、是否保留三段式流程、是否安装与验证。目标目录不存在或为空时按新建模式复制骨架;已有少量文件且要求对齐时按补齐模式只新增缺失项。复制时排除 node_modules/、dist/、coverage/、logs/、.eslintcache、.env、package-lock.json 等缓存与运行产物;.env.example 只做占位替换。用户授权后执行 npm install,并按 npm run typecheck、npm test、npm run lint 验证。可用 yy-enable-lint 时触发其补齐 lint 支持。
适用场景:新建脚本项目、生成标准目录结构、在空白或轻量项目中补齐脚本工程基础设施。
限制:不用于后端服务、前端项目、单文件脚本片段或成熟项目重构;不复制真实密钥、日志、业务样例与私有数据;不默认覆盖、删除或清空已有文件;不默认执行安装、构建、测试或外部调用。