SuperAPI AI 工具集

react-stack

前端与建站

查看项目

更新于 10-15 21:47

技能介绍

用途:为 Bun 驱动的 React 项目提供统一技术栈决策,只应用与当前任务相关的选择,保留项目已有有效约定,避免把局部改动扩大为整套栈或目录迁移。

主要能力:包含 Web(Next.js App Router、服务端渲染/静态站点、SEO、Vercel)与 Universal(Expo Router、移动优先的 iOS、Android 和 Web)两类 profile;新选择需记入项目上下文,两者都不适用时按项目 AGENTS.md 执行。共用决策包括:Bun 作为唯一运行时与包管理器,保留 bun.lock 并禁止其他包管理器锁文件;typescript-stack/SKILL.md 负责编译器配置、类型与 API 设计、模块边界、语言级代码风格和 TypeScript 校验;Biome 负责 lint、格式化与 import 排序;bun test 单元测试与源码同目录,端到端测试放根目录 e2e/;源码按领域放在 src/ 下,src/app/ 只放框架路由;组件采用 Atomic Design 的 atoms、molecules、organisms 目录,依赖只能向下并就近放置配套文件;Convex 负责应用数据,Clerk 负责身份,后端策略见 convex-conventions/SKILL.md;默认 Clerk Billing,仅在存在有据可查的能力缺口时用 Stripe;默认 Vercel AI Gateway,仅在确认不支持时用原生供应商并隔离该例外;Convex 外使用 Zod,内部使用 Convex validators;Knip 检查死代码,Fallow 报告复杂度与变更热点;用 Portless 提供稳定的 worktree 本地 URL;个人用 .env.local,团队共享密钥后用 Doppler。布局、可观测性、生成器、hooks 或包脚本相关脚手架参考 references/shared-tooling.md,语言无关的仓库策略由 project-structure/SKILL.md 负责。

使用方式:先选择匹配 profile;涉及脚手架、路由、样式、部署或框架升级时阅读 references/web.md 或 references/universal.md。单次 bun run check 会按需运行格式化、lint、测试、类型检查、死代码/健康检查和构建。

限制与边界:新增或升级依赖前需在线核实版本与发布状态,并阅读框架、Convex、Clerk 的升级说明;确认 Bun 及框架/原生包在部署目标上的兼容性。新增本技能未规定的产品或服务属用户决策:应推荐当前 Vercel 友好方案及其版本、适配性与取舍,用户确认后再加入。完成标准为观察到相关项目门禁通过;依赖变更后在目标运行时上冻结安装并运行 bun run check 通过,仅当该检查未覆盖同一构建与运行时时才单独跑生产构建。