用bun-runtime技能让AI代理完成从Node到Bun的迁移
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
原文链接:用bun-runtime技能让AI代理完成从Node到Bun的迁移(cccskills)
技能页面:bun-runtime
本文结论
安装bun-runtime后,可以让AI代理以Bun为前提推进执行、依赖包管理、构建、bun test测试以及Vercel配置等工作。
这是一个面向JavaScript和TypeScript开发者的技能。
本文将依次介绍从Node的替换方式、安装方法、请求示例,以及迁移前后需要确认的要点。
安装bun-runtime后,可以让代理以Bun为前提,替换Node项目中的执行、依赖管理和测试。
请求示例如下:
请将这个Node项目迁移到Bun。
也希望测试能用bun test运行。
代理会按照技能中的迁移步骤,将以node和npm编写的命令替换为Bun命令。
依赖包通过bun install重新安装,并生成文本格式的锁文件bun.lock。
替换对应关系如下表所示:
| Node・npm写法 | Bun写法 |
|---|---|
| node script.js | bun run script.js 或 bun script.js |
| npm install | bun install |
| npm run dev | bun run dev |
| npx单次执行 | bun x |
测试采用从bun:test导入expect和test的写法。
由于API与Jest相似,无需从头学习新的写法。
bun-runtime是一份操作指南,用于将Bun作为运行时(执行程序的运行环境)、包管理器、打包器和测试运行器四合一使用。
从执行到发布构建可以统一使用一个工具,因此可以让代理以同一套规范开展工作。
技能中也包含了选择Bun还是Node的参考标准。
拿不定主意时可参考下表:
| 选择 | 适合场景 |
|---|---|
| Bun | 新JS・TS项目、安装和执行速度重要的脚本、在Bun运行时上Vercel部署、想将执行・安装・测试・构建合并为一体时 |
| Node | 以生态系统兼容性为最优先时、依赖Node的老旧工具、使用Bun存在已知问题的依赖包时 |
TypeScript文件可以像bun src/index.ts这样直接执行。
依赖的添加、删除、更新分别用bun add、bun remove、bun update完成,过时的依赖用bun outdated列出。
读取.env文件并执行的写法也在技能的范围之内。
也支持将多个包整合到一个仓库的Monorepo结构。
在package.json中列出workspaces的方式与npm和yarn相同。
只针对特定包运行脚本时使用bun run --filter。
文件读写、HTTP服务器、SQLite、SQL数据库、Redis、S3兼容存储均可使用Bun的内置功能编写。
技能的原则是在引入外部包之前,优先用内置功能解决。
使用内置的打包器和转译器,将应用或库打包为可发布的形式。
构建通过bun run build或bun build ./src/index.ts --outdir=dist的形式执行。
运行全部测试的命令是bun test。
加上--watch后,会随文件变更自动重新运行。
针对CI场景,也整理了Bun 1.4中可用的选项:
| 选项 | 用途 |
|---|---|
| --changed | 只运行受变更影响的测试 |
| --parallel | 通过工作进程并行执行 |
| --shard=<n>/<count> | 在CI中分片执行测试 |
| --isolate | 每个文件使用独立的全局环境执行 |
在Vercel上,需在vercel.json中写入bunVersion以指定Bun 1.4。
部署时的安装通过bun install --frozen-lockfile执行,以精确还原锁文件中记录的依赖。
{
"bunVersion": "1.4.x"
}
安装只需一行命令。
使用npx skills add可以选择安装目标代理,支持Claude Code和Codex等。
npx skills add https://github.com/affaan-m/ECC --skill bun-runtime
如果想让代理帮你安装,请将以下内容原样发送:
次の Agent Skill をインストールしてください。
https://github.com/affaan-m/ECC/tree/main/skills/bun-runtime
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/bun-runtime/、Codex なら ~/.agents/skills/bun-runtime/ に配置してください。
存放位置根据是否用于全部项目或仅用于特定项目而有所不同:
| 代理 | 用于全部项目 | 仅用于特定项目 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 项目的.claude/skills/ |
| Codex | ~/.agents/skills/ | 项目的.agents/skills/ |
包含的文件只有SKILL.md一个。
发布来源为affaan-m/ECC,许可证为MIT。
典型的使用场景有三类:新项目启动、现有项目迁移,以及测试与部署配置。
我想用TypeScript新建一个API服务器。
用Bun开始,也请加入测试和构建配置。
这个请求会生成使用Bun.serve的HTTP服务器,以及用bun:test编写的测试文件。
依赖通过bun install安装,构建通过bun build输出到dist目录。
请整理这个Node项目迁移到Bun的步骤以及兼容性确认要点。
返回结果包括脚本替换对照表,以及用bun install创建锁文件的步骤。
同时,依赖原生扩展或Node专有内部功能的依赖包会作为需要确认的要点列出。
请用bun test编写测试,并准备Vercel的构建配置。
测试文件和指定了bunVersion的vercel.json会一并生成。
部署步骤采用bun install --frozen-lockfile与bun run build的组合。
由于本技能是使用Bun命令的操作指南,需要在本地先安装Bun本体。
步骤以Bun 1.4.x为基准。
CLI的参数标志会随版本变化,请先用bun --version确认版本后再使用。
Bun与Node的兼容性并不完全。
部分原生扩展、较少使用的node:内部API,以及依赖Node专有内部功能的包可能会运行失败。
迁移后请务必执行测试,在正式依赖之前先确认运行状态。
依赖操作也需注意。
bun audit会向注册表查询bun.lock中记录的包名和版本。
如果有公司内部的私有包,请确认数据发送目标。
bun audit fix是更新依赖并重新安装的命令。
因此,锁文件和已安装的包会发生变化。
--isolate只是为每个文件分隔全局环境,并不是进程或安全层面的沙箱。
Vercel的配置请在确认vercel.json内容后再应用。
技能本身也建议在安装前先阅读SKILL.md的内容,以确保安全。
不一定。
大多数包可以运行,但兼容性并非100%。
依赖原生扩展或Node专有内部功能的包,迁移前需要进行验证。
当前Bun的标准锁文件是文本格式的bun.lock。
旧的二进制格式bun.lockb也可以在迁移时被读取。
新项目使用的是bun.lock。
是的。
将bun.lock提交到版本库以便还原相同依赖,是技能最佳实践中明确列出的做法。
在Vercel上需与--frozen-lockfile配合使用。
步骤是以Bun 1.4.x为基准编写的。
使用其他版本时,请查阅已安装版本的帮助文档或官方文档,确认各参数标志的支持情况。
bun-runtime是一份将Bun的执行、依赖管理、构建、测试和Vercel配置整合在一起的操作指南。
在从Node迁移时,代理会帮你整理命令替换对照表和兼容性确认要点。
但请注意,迁移后的测试执行和vercel.json的确认需要自己完成。
详情请参阅cccskills页面。
本文转载自 cccskills 的文章「用bun-runtime技能让AI代理完成从Node到Bun的迁移」。
技能详情和安装方法请访问 cccskills 的 bun-runtime 页面。