SuperAPI AI 工具集

environment-bootstrap

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:为项目建立并维护一致的开发环境。核心原则是每次会话都从已知可用的环境状态开始;使用时会声明“I'm using environment-bootstrap to set up the development environment.”

适用时机:首次克隆仓库时创建 init 脚本;开始新会话时运行该脚本;拉取变更后如依赖变化则重新运行;环境疑似损坏时运行以重置。

主要能力:init 脚本通常放在 scripts/init.sh,流程包括检查前置依赖(如 node、pnpm、git、gh)、校验版本(如 Node 18+)、确认 gh 认证、安装依赖(pnpm install --frozen-lockfile)、按 .env.example 生成 .env、执行构建与测试、在存在 docker-compose 时启动并验证 postgres/redis 等服务,必要时启动开发服务器并做健康检查(优先 IPv6 [::1],回退 127.0.0.1)。

使用方式:先赋予执行权限 chmod +x scripts/init.sh;标准运行 ./scripts/init.sh;需要同时启动开发服务器时 START_DEV_SERVER=true ./scripts/init.sh。冒烟测试可单独写成 scripts/smoke-test.sh,检查构建、测试、开发服务器启动、健康检查 curl http://[::1]:3000/health 返回 200 OK 以及基础 E2E 流程。

维护与重置:新增前置依赖、环境变量、构建流程变化或新增验证步骤时更新脚本并提交。环境异常时可删除 node_modules dist .cache .next,执行 pnpm store prune 后重新运行 init。常见问题包括命令缺失、权限不足、Node 版本不符、依赖安装失败和构建报错。该技能可被 session-start 与 error-recovery 调用。

限制:资料仅以 Node/pnpm 示例呈现,未说明对其他语言栈的支持;具体前置条件、环境变量与验证项需按项目实际补充。