@dtt_siye/atool 1.1.0

package/skills/project-analyze/rules/mobile-flutter.md

@@ -0,0 +1,315 @@
+# Flutter / Dart 项目分析规则
+
+## 分析粒度
+
+按 Feature 模块和分层架构（Pages / Widgets / Providers / Services / Models）进行分析。
+
+```
+MaterialApp / runApp
+    ↓
+Navigator / GoRouter（路由）
+    ↓
+Pages / Screens（页面）
+    ↓
+Widgets（组件）
+    ↓
+ChangeNotifier / Riverpod / Bloc（状态管理）
+    ↓
+Repository / Service（数据层）
+    ↓
+Models / Entities（数据模型）
+```
+
+## 目录扫描策略
+
+### 1. 识别项目结构
+
+**信号文件检测：**
+- `pubspec.yaml` → Flutter/Dart 项目
+- `lib/` → Dart 源码目录
+- `android/`, `ios/`, `web/`, `macos/`, `linux/`, `windows/` → 平台目录
+
+### 2. 识别状态管理方案
+
+**从 `pubspec.yaml` 的 dependencies 检测：**
+- Provider: `provider` 依赖
+- Riverpod: `flutter_riverpod`, `hooks_riverpod` 依赖
+- BLoC: `flutter_bloc`, `equatable` 依赖
+- GetX: `get` 依赖
+- MobX: `mobx`, `flutter_mobx` 依赖
+
+### 3. 识别路由方案
+
+- GoRouter: `go_router` 依赖 + `GoRouter` 配置
+- AutoRoute: `auto_route` 依赖 + `@RoutePage()` 注解
+- Navigator 1.0: `Navigator.push()` 调用
+- GetX: `Get.to()` / `GetPage()` 调用
+
+### 4. 依赖提取
+
+从 `pubspec.yaml` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| 网络 | dio, http, retrofit |
+| 状态管理 | provider, riverpod, flutter_bloc, get |
+| 路由 | go_router, auto_route |
+| 本地存储 | shared_preferences, hive, isar, drift |
+| DI | get_it, injectable, riverpod |
+| UI | cached_network_image, shimmer, lottie |
+| 序列化 | json_serializable, freezed, dart_mappable |
+
+### 5. 按层扫描路径
+
+- **Pages/Screens**: `lib/screens/`, `lib/pages/`, `lib/views/`
+- **Widgets**: `lib/widgets/`, `lib/components/`, `lib/ui/`
+- **状态管理**: `lib/providers/`, `lib/bloc/`, `lib/cubit/`, `lib/notifiers/`
+- **Models**: `lib/models/`, `lib/entities/`
+- **Services**: `lib/services/`, `lib/repositories/`
+- **Routes**: `lib/routes/`, `lib/navigation/`, `lib/app_router.dart`
+- **Utils**: `lib/utils/`, `lib/helpers/`, `lib/constants/`
+- **Theme**: `lib/theme/`, `lib/styles/`
+
+## 各层提取规则
+
+### 层 1: 路由层
+
+**扫描文件**: `lib/app_router.dart`, `lib/routes/**/*.dart`, `lib/navigation/**/*.dart`
+
+**提取内容**:
+- 路由配置（路径 + 对应 Widget + 参数）
+- 嵌套路由（ShellRoute / 子路由）
+- 路由守卫（重定向逻辑、认证检查）
+- Deep Link 配置
+
+**输出示例**:
+```
+### 路由结构（GoRouter）
+- **文件**: `lib/app_router.dart`
+- **路由配置**:
+  | 路径 | 目标 Widget | 参数 | 守卫 |
+  |------|-------------|------|------|
+  | / | SplashScreen | - | - |
+  | /login | LoginPage | - | 已登录→重定向/home |
+  | /home | HomePage | - | 需认证 |
+  | /profile/:userId | ProfilePage | userId: String | 需认证 |
+  | /settings | SettingsPage | - | 需认证 |
+- **嵌套路由**: /home 下包含 /home/feed, /home/search, /home/profile (BottomNavigation)
+- **认证守卫**: redirect 检查 authProvider.isAuthenticated
+```
+
+### 层 2: 页面层
+
+**扫描文件**: `lib/pages/**/*.dart`, `lib/screens/**/*.dart`
+
+**提取内容**:
+- 页面 Widget 类名 + 路径
+- State 管理方式（StatefulWidget / StatelessWidget + Provider）
+- `build()` 方法中的主要子 Widget（1-2 层）
+- 生命周期方法（initState, dispose）
+- 使用的 Provider / Bloc
+
+**输出示例**:
+```
+### HomePage
+- **路径**: `lib/pages/home/home_page.dart`
+- **类型**: StatefulWidget
+- **State**: _HomePageState
+- **build() 主要结构**:
+  Scaffold(
+    appBar: AppBar(title: Text('首页')),
+    body: _buildBody(),    // TabBarView(FeedPage, SearchPage, ProfilePage)
+    bottomNavigationBar: MainBottomNavBar(onTap: _onTabTapped),
+  )
+- **Provider 依赖**: feedProvider (Watch), authProvider (Read)
+- **生命周期**:
+  | 方法 | 行为 |
+  |------|------|
+  | initState() | 初始化 TabController, 加载用户信息 |
+  | dispose() | 释放 TabController |
+```
+
+### 层 3: Widget 层
+
+**扫描文件**: `lib/widgets/**/*.dart`, `lib/components/**/*.dart`
+
+**提取内容**:
+- Widget 类名 + 类型（StatefulWidget / StatelessWidget）
+- 构造参数（命名参数 + 类型 + 默认值）
+- `build()` 方法中的子 Widget
+- 动画配置（AnimationController, Tween）
+
+**输出示例**:
+```
+### UserAvatar
+- **路径**: `lib/widgets/user_avatar.dart`
+- **类型**: StatelessWidget
+- **构造参数**:
+  | 参数 | 类型 | 必填 | 默认值 | 说明 |
+  |------|------|------|--------|------|
+  | avatarUrl | String? | No | null | 头像 URL |
+  | size | double | No | 48.0 | 头像尺寸 |
+  | name | String | Yes | - | 用于生成默认头像 |
+- **子 Widget**: CachedNetworkImage + fallback (首字母头像)
+```
+
+### 层 4: 状态管理层
+
+#### Provider
+
+**扫描文件**: `lib/providers/**/*.dart`
+
+**提取内容**:
+- Provider 名称 + 类型（ChangeNotifier / FutureProvider / StateNotifier）
+- State 字段（名称 + 类型）
+- 方法（签名 + 说明）
+
+**输出示例**:
+```
+### AuthProvider（ChangeNotifier）
+- **路径**: `lib/providers/auth_provider.dart`
+- **State**:
+  | 字段 | 类型 | 说明 |
+  |------|------|------|
+  | user | User? | 当前用户 |
+  | isLoading | bool | 加载状态 |
+  | isAuthenticated | bool | 是否已认证（getter） |
+- **方法**:
+  | 方法 | 签名 | 说明 |
+  |------|------|------|
+  | login | (String email, String password) → Future<void> | 登录 |
+  | logout | () → Future<void> | 登出 |
+  | updateProfile | (UpdateProfileDTO) → Future<void> | 更新资料 |
+- **持久化**: SharedPreferences (token), Hive (user)
+```
+
+#### BLoC
+
+**扫描文件**: `lib/bloc/**/*.dart`, `lib/cubit/**/*.dart`
+
+**提取内容**:
+- Bloc/Cubit 名称
+- State 类（字段 + 类型）
+- Event/输入（名称 + 关联字段）
+- Emitted States（每个 Event 触发的 State 变化）
+
+**输出示例**:
+```
+### AuthBloc
+- **路径**: `lib/bloc/auth/auth_bloc.dart`
+- **State**: `AuthState(user: User?, status: AuthStatus, error: String?)`
+- **Events**:
+  | Event | 字段 | 触发的 State 变化 |
+  |-------|------|-------------------|
+  | AuthLoginRequested | email, password | status: loading → authenticated / failure |
+  | AuthLogoutRequested | - | status: authenticated → unauthenticated |
+  | AuthRefreshRequested | - | 重新获取用户信息 |
+```
+
+### 层 5: Service / Repository 层
+
+**扫描文件**: `lib/services/**/*.dart`, `lib/repositories/**/*.dart`
+
+**提取内容**:
+- 类名 + 依赖注入方式
+- 方法签名 + API 端点映射
+- 错误处理策略
+
+**输出示例**:
+```
+### UserRepository
+- **路径**: `lib/repositories/user_repository.dart`
+- **依赖**: Dio (http client), UserLocalDataSource
+- **方法**:
+  | 方法 | HTTP | 路径 | 返回类型 |
+  |------|------|------|----------|
+  | getUserProfile() | GET | /api/user/profile | Future<User> |
+  | updateProfile(data) | PUT | /api/user/profile | Future<User> |
+  | changePassword(data) | POST | /api/user/password | Future<void> |
+```
+
+### 层 6: 样式/主题层
+
+**扫描文件**: `lib/theme/**/*.dart`, `lib/styles/**/*.dart`
+
+**提取内容**:
+- ThemeData 配置
+- 颜色定义（ColorScheme）
+- 字体配置（TextTheme）
+- 间距系统
+- 自定义组件主题
+
+**输出示例**:
+```
+### AppTheme
+- **文件**: `lib/theme/app_theme.dart`
+- **颜色**:
+  | Token | 值 | 用途 |
+  |-------|------|------|
+  | primaryColor | Color(0xFF6750A4) | 主色调 |
+  | onPrimaryColor | Color(0xFFFFFFFF) | 主色上的文字 |
+  | errorColor | Color(0xFFB3261E) | 错误色 |
+- **字体**:
+  | 用途 | 字体族 | 字号 | 字重 |
+  |------|--------|------|------|
+  | headlineLarge | Roboto | 32sp | Bold |
+  | bodyMedium | Roboto | 14sp | Normal |
+```
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {项目名}
+
+## 项目概述
+App 功能描述
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+
+## 路由结构
+路由树 + 参数 + 守卫
+
+## 状态管理
+Provider/BLoC 关系图
+
+## 模块详解
+按 Feature 分组
+
+## 依赖管理
+pubspec.yaml 关键依赖
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 页面/视图层 | `lib/features/{name}/`, `lib/screens/` | 每个子目录 | 目录名 kebab-case |
+| API/服务层 | `lib/services/`, `lib/repositories/` | 每个子目录或文件 | 名称 kebab-case |
+| 状态管理层 | `lib/providers/`, `lib/notifiers/` | 每个文件 | 文件名去后缀 kebab-case |
+| 组件层 | `lib/widgets/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| 数据模型层 | `lib/models/` | 每个文件 | 文件名去后缀 kebab-case |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `main.dart`, `app.dart`）
+- 纯导出桶文件（仅有 re-export）
+- 工具函数目录（`lib/utils/`, `lib/helpers/`）— 合并为一个模块
+- 生成文件（`*.g.dart`, `*.freezed.dart`）跳过
+- 平台目录（`android/`, `ios/`）跳过
+
+## Token 管理
+
+- 大模块（>20 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- `pubspec.yaml` 分析单独一个子任务
+- 生成的文件（`*.g.dart`, `*.freezed.dart`）跳过或简要分析
+- 平台目录（android/, ios/）不分析

package/skills/project-analyze/rules/mobile-react-native.md

@@ -0,0 +1,283 @@
+# React Native 项目分析规则
+
+## 分析粒度
+
+按 Screen、Component、Navigation、Service 分层分析。
+
+```
+App.tsx / App.js（入口）
+    ↓
+Navigation（导航）
+    ↓
+Screens（页面）
+    ↓
+Components（组件）
+    ↓
+Hooks / Context（逻辑复用）
+    ↓
+Services / API（数据层）
+    ↓
+Stores / State（状态管理）
+    ↓
+Utils / Types（工具/类型）
+```
+
+## 目录扫描策略
+
+### 1. 识别项目类型
+
+**信号文件检测：**
+- `app.json` / `app.config.js` → Expo 项目
+- `android/app/build.gradle` + `ios/Podfile` → Bare React Native
+- `metro.config.js` → Metro bundler 配置
+
+### 2. 识别导航方案
+
+- React Navigation: `@react-navigation/native` 依赖
+- Expo Router: `expo-router` 依赖 + `app/` 目录
+- Native Stack / Tab / Drawer Navigator
+- Deep Linking 配置
+
+### 3. 识别状态管理
+
+- Redux Toolkit: `@reduxjs/toolkit`, `react-redux`
+- Zustand: `zustand`
+- MobX: `mobx`, `mobx-react`
+- Context API: React 内置
+- Recoil: `recoil`
+
+### 4. 依赖提取
+
+从 `package.json` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| 导航 | @react-navigation/native, expo-router |
+| 状态管理 | @reduxjs/toolkit, zustand, mobx |
+| 网络 | axios, fetch, @tanstack/react-query |
+| 存储 | @react-native-async-storage/async-storage, MMKV |
+| UI | react-native-paper, native-base, tamagui |
+| 动画 | react-native-reanimated, react-native-gesture-handler |
+| 图片 | react-native-fast-image, expo-image |
+| 原生模块 | 各种 react-native-* bridge 模块 |
+
+### 5. 按层扫描路径
+
+- **Screens**: `src/screens/`, `app/` (Expo Router)
+- **Components**: `src/components/`
+- **Navigation**: `src/navigation/`
+- **Hooks**: `src/hooks/`
+- **Services**: `src/services/`, `src/api/`
+- **Store**: `src/store/`, `src/stores/`
+- **Types**: `src/types/`
+- **Utils**: `src/utils/`, `src/constants/`
+- **Assets**: `src/assets/`, `assets/`
+
+## 各层提取规则
+
+### 层 1: Navigation 层
+
+**扫描文件**: `src/navigation/**/*.tsx`, `app/**/*.tsx` (Expo Router)
+
+**提取内容**:
+- 导航类型（Stack / Tab / Drawer / Bottom Tabs）
+- 路由配置（name + component + options）
+- 屏幕参数类型定义
+- 导航守卫（认证检查）
+
+**输出示例**:
+```
+### 导航结构（React Navigation）
+- **文件**: `src/navigation/AppNavigator.tsx`
+- **类型**: Native Stack
+- **路由配置**:
+  | 路由名 | 组件 | 参数类型 | 选项 |
+  |--------|------|----------|------|
+  | Login | LoginScreen | - | headerShown: false |
+  | Main | BottomTabs | - | gestureEnabled: false |
+  | Home | HomeScreen | - | tabBarIcon: home |
+  | Profile | ProfileScreen | - | tabBarIcon: person |
+  | UserDetail | UserDetailScreen | { userId: string } | title: '用户详情' |
+  | Settings | SettingsScreen | - | - |
+- **认证守卫**: AuthProvider 包裹，未登录→Login，已登录→Main
+```
+
+### 层 2: Screen 层
+
+**扫描文件**: `src/screens/**/*.tsx`
+
+**提取内容**:
+- Screen 组件名 + 路径
+- Props（Navigation Props + 自定义 Props）
+- 使用的 Hooks（useState, useEffect, 自定义 Hook）
+- 使用的 API / Store
+- UI 结构（主要子组件，1-2 层）
+
+**输出示例**:
+```
+### HomeScreen
+- **路径**: `src/screens/Home/HomeScreen.tsx`
+- **Props**: StackScreenProps<HomeParamList, 'Home'>
+- **使用的 Hooks**:
+  | Hook | 用途 |
+  |------|------|
+  | useFeedStore | 获取 feed 列表 |
+  | useRefresh | 下拉刷新 |
+  | useAuth | 获取当前用户 |
+- **使用的 API**: getFeedItems(), getRecommendations()
+- **UI 结构**:
+  FlatList
+    ├── ListHeaderComponent: SearchBar + Banner
+    ├── renderItem: FeedCard
+    └── onRefresh: handleRefresh
+```
+
+### 层 3: Component 层
+
+**扫描文件**: `src/components/**/*.tsx`
+
+**提取内容**:
+- 组件名 + 路径
+- Props TypeScript interface
+- 样式方案（StyleSheet.create / Styled Components / NativeWind）
+- 子组件结构
+
+**输出示例**:
+```
+### FeedCard
+- **路径**: `src/components/Feed/FeedCard.tsx`
+- **Props**:
+  ```typescript
+  interface FeedCardProps {
+    item: FeedItem;
+    onPress?: (item: FeedItem) => void;
+    showActions?: boolean;
+  }
+  ```
+- **子组件**: Avatar, Text, Image, ActionButtons
+- **样式**: StyleSheet.create（内联样式）
+```
+
+### 层 4: Store / 状态管理层
+
+**扫描文件**: `src/store/**/*.ts`, `src/stores/**/*.ts`
+
+**提取内容**:
+- Store 名称 + 类型
+- State 接口
+- Actions / Reducers
+- 异步 Thunk
+
+**输出示例**:
+```
+### feedSlice（Redux Toolkit）
+- **路径**: `src/store/slices/feedSlice.ts`
+- **State**:
+  | 字段 | 类型 | 说明 |
+  |------|------|------|
+  | items | FeedItem[] | Feed 列表 |
+  | loading | boolean | 加载状态 |
+  | error | string \| null | 错误信息 |
+  | hasMore | boolean | 是否有更多 |
+- **Reducers**: appendItems, clearFeed
+- **Async Thunks**: fetchFeedItems, loadMore
+```
+
+### 层 5: Service / API 层
+
+**扫描文件**: `src/services/**/*.ts`, `src/api/**/*.ts`
+
+**提取内容**:
+- API 客户端配置（baseURL, 拦截器）
+- API 函数列表
+- Token 管理
+
+### 层 6: Native Module 层（如适用）
+
+**扫描文件**: `src/native/**/*.ts`, `android/app/src/main/java/**/*Module.kt`, `ios/**/*Bridge.m`
+
+**提取内容**:
+- Native Module 名称
+- 导出方法（@ReactMethod）
+- 参数类型和返回类型
+- 线程配置
+
+**输出示例**:
+```
+### BiometricModule
+- **方法**:
+  | 方法 | 参数 | 返回 | 说明 |
+  |------|------|------|------|
+  | authenticate | (reason: string) | Promise<boolean> | 生物识别认证 |
+  | isAvailable | () | Promise<boolean> | 检查设备支持 |
+- **平台**: iOS (TouchID/FaceID), Android (BiometricPrompt)
+```
+
+### 层 7: 样式层
+
+**扫描文件**: `src/theme/**/*.ts`, `src/styles/**/*.ts`
+
+**提取内容**:
+- 主题配置（颜色、字体、间距）
+- 样式方案（StyleSheet / Styled Components / NativeWind）
+- 暗色模式支持
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {App 名称}
+
+## 项目概述
+App 功能描述
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+
+## 导航结构
+路由树 + 参数 + 导航方式
+
+## 状态管理
+Store 关系图
+
+## 模块详解
+按 Screen 分组
+
+## 原生模块
+Bridge 方法列表
+
+## 依赖管理
+关键 npm 依赖
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 页面/视图层 | `src/screens/`, `src/views/` | 每个子目录或文件 | 名称 kebab-case |
+| API/服务层 | `src/services/`, `src/api/` | 每个子目录 | 目录名 kebab-case |
+| 状态管理层 | `src/store/`, `src/stores/` | 每个子目录 | 目录名 kebab-case |
+| 组件层 | `src/components/{name}/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| Hooks 层 | `src/hooks/` | 每个文件 | 文件名去后缀 kebab-case |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `App.tsx`, `index.js`）
+- 纯导出桶文件（`index.ts` 仅有 re-export）
+- 工具函数目录（`src/utils/`, `src/helpers/`）— 合并为一个模块
+- 生成文件（`*.generated.ts`）跳过
+
+## Token 管理
+
+- 大模块（>20 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- `package.json` 分析单独一个子任务
+- `android/` 和 `ios/` 原生代码只分析 bridge 文件
+- 自动生成的文件（`*.generated.ts`）跳过