用途:该技能为 Bun 开发提供自包含知识与一套有明确取向的规则集,用于运行时选型、从 Node 迁移、包管理器与锁文件治理、配置、测试与构建,也可在安装 codex-dev 后启用审计与安全修复的自动化引擎;零工具时仅靠知识部分也可使用。
主要能力:Bun 是集运行时、包管理器、打包器与测试运行器于一体的 JavaScript/TypeScript 工具包,单一 bun 二进制交付。关键文件为 bunfig.toml、bun.lock(Bun 1.2 起默认的文本锁文件)、package.json。覆盖运行时直接执行 .ts/.tsx/.jsx/.js、依赖安装与工作区管理、bun build 打包与单文件可执行文件、Jest 兼容的 bun test,以及 Bun.serve()、Bun.file()、Bun.write()、bun:sqlite、Bun.$ 等服务与 IO 能力,并涉及 monorepo 过滤与并行执行、Vercel 上的 Bun 运行时(Beta)。
使用方式:常用命令包括 bun index.ts、bun run start、bun install、bun ci、bun add、bun remove、bun audit、bun test(可加 --coverage、--shard=M/N、--changed)、bun build ./index.ts --outdir ./dist、bunx。规则按包管理与锁文件、运行时选型、Vercel 运行时、脚本与 monorepo、TypeScript 与工具链、测试、构建、性能、迁移与排错等类别组织。安装 codex-dev 后可用 codex-dev --json bun audit --root .、bun fixes plan/apply、bun validate run --root . --fail-on warn 等命令。
限制与注意事项:Bun 1.2+ 写 bun.lock,bun.lockb 为旧格式;生命周期脚本默认禁用,postinstall 需加入 trustedDependencies;run 标志需写在脚本名之前;使用顶层 await 的文件不能被 require();bun build 默认不内联 process.env,需 --env inline;Bun.serve() 空闲连接约 10 秒超时,SSE 需设置 idleTimeout;Bun.serve() 在 Vercel Functions 上不支持。参考资料为固定 Bun 版本的快照,更新内容应查阅 https://bun.com/docs/llms.txt,必要时用 codex-dev bun references plan 与 sync 刷新。