SuperAPI AI 工具集

tanstack-start-architecture

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:在审查或改动现有 TanStack Start / TanStack Router 项目架构时使用,尤其涉及路由结构、路由本地目录、loaders、server functions、server routes、middleware、import protection、SSR/水合、平台配置以及共享嵌套目录组织。不适用场景:非 TanStack Start/Router 项目、仅通用 React/Vite 架构审查、纯文档摘要、与 Start 架构无关的安全/部署/测试修复。

主要能力:先校验项目是否为 Start/Router 项目(如检查 app.config.ts、package.json 中 @tanstack/react-start 或 @tanstack/react-router、src/routes/__root.tsx),再按触碰面读取对应规则文件(architecture-rules.md 及 rules/ 下的 project-structure、routes、services、hooks、import-protection、middleware、execution-model、server-routes、ssr-hydration、platform、conventions、validation),官方 API 事实放在 references/official/ 以便随时刷新。规则分为 Official(官方行为)、Safety policy(安全/运行时阻断规则)、Hypercore convention(可严于官方的团队约定);用户明确要求官方默认时放宽团队约定但保留官方与安全规则。

使用方式:仅在有 Start/Router 指示的项目上执行;按任务需要读取支持文件,分类适用规则后自动应用安全、局部、可回滚的修复,宽泛迁移需用户明确要求才执行,交付前运行 rules/validation.md 检查。

适用场景:审计 server function、loader 与 importProtection 违规;新增带搜索参数的路由并保持架构合规;重构 Start 路由目录、hooks 与 server functions;检查 loader 边界与 server function 结构;审查嵌套 src/modules 或 src/lib 分组。

限制与安全边界:不得在 isomorphic loader/客户端可达代码中读取密钥、数据库、文件系统或特权 SDK;不得让仅服务端导入脱离 createServerFn、createServerOnlyFn 等编译器可识别边界;不得关闭导入保护或覆盖已有 tanstackStart() 配置;变更类 server function 必须做运行时输入校验;不得把不可信 sendContext 当作已校验数据;不得让首次渲染输出不稳定(如 Date.now()、随机 ID、语言/时区差异)而无稳定策略。默认面向用户的交付物使用韩语。技能单次执行一轮,应用修复后只跑一次校验,用户再次要求时才重跑。