用途:在现有 Vite + TanStack Router 项目中执行架构审查、实现指导与合规检查,覆盖路由结构、路由本地目录、loaders、validateSearch、service/query 层、自定义 hooks、Vite 插件配置、生成的路由树、env/alias 安全与共享嵌套目录组织。
主要能力:先确认仓库确为 Vite + TanStack Router(检查 @tanstack/react-router、vite、vite.config.ts、src/routes/__root.tsx 等指示);再按分层约定 Routes -> Services -> External API 校验,阻止路由或 hooks 直接调用 fetch/axios、服务返回原始 Response、使用 Vite 中的 Start 专属 API(createServerFn、useServerFn 等)。同时检查路由文件夹结构(-components/、-hooks/,禁止 -functions/)、export const Route、搜索参数用 zodValidator、hooks 内部顺序与导出返回类型、kebab-case 文件名、const 箭头函数、显式返回类型、导入顺序、韩文块注释等。
使用方式:先读 architecture-rules.md,再按触及面读 rules/ 下对应规则文件,API 易漂移时读官方参考;改动技能目录后运行 scripts/validate-vite-architecture-skill.mjs。按 Step 1 至 Step 5 执行:项目验证、读规则、变更前安全门检、实现、变更后验证。仅对局部、可逆、低风险问题自动修复;大规模重命名、路由树重构、引入 SSR、大范围 auth/API 重写等不得擅自迁移。
适用场景:既有 Vite + TanStack Router 项目中的架构审查、路由与 service 边界调整、hooks 抽取、插件与环境配置检查。
限制:项目使用 @tanstack/react-start 或 app.config.ts 时不适用,只返回 Start 边界说明;纯 Vite 无 TanStack Router 不适用;仅文档总结不适用。部分规则比 TanStack Router 默认更严格,属该项目团队约定;输出默认韩文,用户明确要求时才用其他语言。收费、价格、平台与效果暂未提供。