create-route

重要提示

在开始创建之前，请务必阅读以下关键规范：

必读规范：

• .agents/rules/03-项目结构.md - 目录结构要求（特别是 index.module.scss）
• .agents/rules/06-路由规范.md - 路由配置约束

常见错误警告：

• 样式文件必须使用 .module.scss 后缀，禁止使用 .scss
• 路由目录名使用 kebab-case，例如 login、ai-editor
• 必须在全局唯一路由入口注册，禁止多处维护同一条路由

---

标准路由目录结构

每个路由对应 src/routes/<route-name>/ 目录：

src/routes/login/
  ├─ Page.tsx              # 页面主组件
  ├─ Loader.tsx            # 懒加载包装
  └─ index.module.scss     # 样式文件（必须是 .module.scss）

关键要求：

• 样式文件后缀：index.module.scss（非 .scss）
• 组件导出：默认导出 Page 组件
• 目录名：kebab-case

---

步骤 1：创建 Page 组件

// src/routes/login/Page.tsx
import React from 'react';
import styles from './index.module.scss';  // 必须是 .module.scss

const LoginPage: React.FC = () => {
  return <div className={styles.loginPage}>LoginPage</div>;
};

export default LoginPage;

验证点：

• [ ] 文件名为 Page.tsx
• [ ] 样式导入为 ./index.module.scss
• [ ] 默认导出组件

---

步骤 2：创建 Loader 组件（懒加载）

// src/routes/login/Loader.tsx
import React from 'react';
import {ErrorBoundary, RouterLoading} from '@/components';

const Component = React.lazy(
  () => import(/* webpackChunkName: "login" */ './Page')
);

const Loader: React.FC = () => {
  return (
    <ErrorBoundary>
      <React.Suspense fallback={<RouterLoading />}>
        <Component />
      </React.Suspense>
    </ErrorBoundary>
  );
};

export default Loader;

验证点：

• [ ] 文件名为 Loader.tsx
• [ ] 使用 React.lazy 懒加载 Page
• [ ] 包含 ErrorBoundary 和 RouterLoading
• [ ] 不在 Loader 中声明路由

---

步骤 3：在全局路由中注册

在 src/routes/index.tsx 中注册：

import LoginLoader from './login/Loader';

const routes = [
  {
    path: '/login',
    element: <LoginLoader />,
    isAuthenticated: true,  // 根据实际需求设置
  },
  // ...
];

验证点：

• [ ] 只在唯一路由入口注册
• [ ] 导入路径正确 ./login/Loader

---

步骤 4：验证文件结构

创建完成后，检查目录结构是否符合规范：

src/routes/<route-name>/
  ├─ Page.tsx              ✓
  ├─ Loader.tsx            ✓
  └─ index.module.scss     ✓（必须是 .module.scss）

快速验证命令：

ls -la src/routes/<route-name>/

应该看到三个文件，且样式文件后缀为 .module.scss。

---

页面级组件放置

如果页面需要专用组件，创建 components/ 目录：

src/routes/ai-editor/
  ├─ Page.tsx
  ├─ Loader.tsx
  ├─ index.module.scss
  └─ components/           # 页面专用组件
      └─ xxx/
          ├─ index.tsx
          └─ index.module.scss

组件放置规则（详见 .agents/rules/04-组件规范.md）：

• 页面级组件（仅当前页面使用）→ src/routes/<route>/components/
• 通用组件（多处复用）→ src/components/

---

快速检查清单

创建完成后，逐项核对：

• [ ] 路由目录名为 kebab-case
• [ ] 存在 Page.tsx
• [ ] 存在 Loader.tsx
• [ ] 存在 index.module.scss（非 .scss）
• [ ] Page 中样式导入为 ./index.module.scss
• [ ] Loader 只负责懒加载 Page
• [ ] 路由在唯一入口文件注册
• [ ] 组件放置位置正确（通用 vs 页面级）

样式还原检查：涉及 UI 还原的样式开发，请参考 .agents/skills/create-proposal/SKILL.md 中的「样式还原验证检查清单」及对应页面的 docs/样式还原/<名称>-UI分析清单.md。