@dtt_siye/atool 1.1.0

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

@@ -0,0 +1,323 @@
+# iOS / Swift 项目分析规则
+
+## 分析粒度
+
+按 Feature 模块和 MVVM / MVVM+Coordinator 层次进行分析。
+
+```
+App Entry Point
+    ↓
+Coordinator / Router（导航）
+    ↓
+ViewController / SwiftUI View（视图）
+    ↓
+ViewModel / ObservableObject（逻辑）
+    ↓
+Model / Entity（数据）
+    ↓
+Service / Repository（网络/持久化）
+    ↓
+Extensions / Utils（工具）
+```
+
+## 目录扫描策略
+
+### 1. 识别项目类型
+
+**信号文件检测：**
+- `.xcodeproj` / `.xcworkspace` → Xcode 项目
+- `Package.swift` → Swift Package
+- 依赖管理：SPM（Package Dependencies）、CocoaPods（`Podfile`）、Carthage（`Cartfile`）
+
+### 2. 识别架构模式
+
+- **MVVM**: ViewModels 目录 + Bindings / Combine
+- **MVC**: Controllers 目录，无 ViewModel
+- **VIPER**: View / Interactor / Presenter / Entity / Router 目录
+- **Clean Architecture**: Domain / Data / Presentation 分层
+- **SwiftUI + TCA**: Reducers / Effects / Store 模式
+
+### 3. 识别 UI 框架
+
+- **UIKit**: `import UIKit`, `.storyboard`, `.xib`, `ViewController`
+- **SwiftUI**: `import SwiftUI`, `ContentView: View`, `@StateObject`
+- **混合**: 两者并存（`UIHostingController` 桥接）
+
+### 4. 依赖提取
+
+从 `Package.swift` / `Podfile` / `Cartfile` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| 网络 | Alamofire, Moya, URLSession |
+| 响应式 | RxSwift, Combine |
+| DI | Swinject, Kodein, Factory |
+| 存储 | CoreData, Realm, SwiftData, UserDefaults |
+| 导航 | RxFlow, Coordinator Pattern |
+| UI | SnapKit, Kingfisher, Lottie |
+| 测试 | XCTest, Quick/Nimble, OHHTTPStubs |
+
+### 5. 按层扫描路径
+
+- **View 层**: `*/Views/`, `*/Screens/`, `*/UI/`, `*/Scenes/`
+- **ViewModel 层**: `*/ViewModels/`, `*/Presenters/`, `*/Reducers/`
+- **Model 层**: `*/Models/`, `*/Entities/`, `*/DTOs/`
+- **Coordinator/Router 层**: `*/Coordinators/`, `*/Routers/`, `*/Navigation/`
+- **Service 层**: `*/Services/`, `*/Network/`, `*/API/`, `*/Repositories/`
+- **Extensions**: `*/Extensions/`, `*/+Extensions/`
+- **Resources**: `*/Resources/`, `*/Assets.xcassets/`
+
+## 各层提取规则
+
+### 层 1: Coordinator / Router 导航层
+
+**扫描文件**: `*Coordinator.swift`, `*Router.swift`, `*Navigator.swift`
+
+**提取内容**:
+- Coordinator 类名 + 管理的页面列表
+- 导航方法（方法签名 + 目标页面 + 传递的参数）
+- 导航模式（push / present / modal / sheet）
+- Deep Link 处理
+
+**输出示例**:
+```
+### AppCoordinator
+- **路径**: `Coordinators/AppCoordinator.swift`
+- **管理的页面**: LoginFlow → MainTabBar → (Home, Profile, Settings)
+- **导航方法**:
+  | 方法 | 目标 | 参数 | 导航方式 |
+  |------|------|------|----------|
+  | start() | LoginViewController | - | window.rootViewController |
+  | showMain() | MainTabBarController | UserSession | rootViewController 替换 |
+  | showProfile(userId:) | ProfileViewController | userId: String | push |
+  | showSettings() | SettingsViewController | - | present (modal) |
+  | showEditProfile() | EditProfileViewController | - | present (fullScreen) |
+```
+
+### 层 2: ViewController / SwiftUI View 层
+
+**扫描文件**: `*ViewController.swift`, `*View.swift`（SwiftUI）
+
+#### UIKit ViewController
+
+**提取内容**:
+- 类名 + 继承关系
+- IBOutlet 列表（属性名 + 类型）
+- IBAction 列表（方法名 + 关联事件）
+- 生命周期方法（viewDidLoad, viewWillAppear 等）
+- 使用的 ViewModel
+- UI 配置逻辑（UITableView 代理/数据源、UICollectionView 等）
+
+**输出示例**:
+```
+### UserListViewController
+- **路径**: `Scenes/User/UserListViewController.swift`
+- **继承**: UIViewController
+- **ViewModel**: UserListViewModel
+- **IBOutlet**:
+  | 属性 | 类型 | 关联 UI |
+  |------|------|---------|
+  | tableView | UITableView | 用户列表 |
+  | searchController | UISearchController | 搜索栏 |
+  | activityIndicator | UIActivityIndicatorView | 加载指示器 |
+- **IBAction**:
+  | 方法 | 关联事件 | 说明 |
+  |------|----------|------|
+  | @IBAction addButtonTapped | UIBarButtonItem.tap | 新增用户 |
+- **生命周期**:
+  | 方法 | 行为 |
+  |------|------|
+  | viewDidLoad() | 绑定 ViewModel、配置 tableView、触发初始加载 |
+  | viewWillAppear() | 刷新数据 |
+- **UITableView 配置**:
+  - Cell: UserTableViewCell (register nib)
+  - 高度: 80pt (自动布局)
+  - 下拉刷新: UIRefreshControl → viewModel.reload()
+```
+
+#### SwiftUI View
+
+**提取内容**:
+- View 结构体名
+- `@State` / `@Binding` / `@ObservedObject` / `@EnvironmentObject` 属性
+- `body` 中的主要子视图（1-2 层）
+- `.modifier()` 链（导航、样式修饰）
+- `.sheet()` / `.fullScreenCover()` / `.navigationDestination()` 修饰
+
+**输出示例**:
+```
+### UserProfileView
+- **路径**: `Views/Profile/UserProfileView.swift`
+- **属性**:
+  | 属性 | 包装器 | 类型 | 说明 |
+  |------|--------|------|------|
+  | viewModel | @StateObject | UserProfileViewModel | 页面 VM |
+  | isEditing | @State | Bool | 编辑模式 |
+  | router | @EnvironmentObject | AppRouter | 导航 |
+- **body 主要结构**:
+  ScrollView {
+    VStack {
+      ProfileHeaderView(viewModel: viewModel)
+        .sheet(isPresented: $isEditing) { EditProfileView() }
+      StatsGridView(stats: viewModel.stats)
+      SettingsListView(items: viewModel.settings)
+    }
+  }
+  .navigationTitle(viewModel.userName)
+  .task { await viewModel.loadProfile() }
+```
+
+### 层 3: ViewModel 层
+
+**扫描文件**: `*ViewModel.swift`, `*Presenter.swift`, `*Reducer.swift`
+
+**提取内容**:
+- 类名 + 遵循的协议（ObservableObject, Observable）
+- Published / @Observable 属性（名称 + 类型 + 说明）
+- Input / Action（用户操作触发的动作）
+- Output / State 变化
+- 依赖的 Service / Repository
+
+**输出示例**:
+```
+### UserListViewModel
+- **路径**: `ViewModels/UserListViewModel.swift`
+- **协议**: ObservableObject
+- **Published 属性**:
+  | 属性 | 类型 | 初始值 | 说明 |
+  |------|------|--------|------|
+  | users | [UserVO] | [] | 用户列表 |
+  | isLoading | Bool | false | 加载状态 |
+  | errorMessage | String? | nil | 错误信息 |
+  | searchText | String | "" | 搜索关键词 |
+- **方法**:
+  | 方法 | 参数 | 返回值 | 说明 |
+  |------|------|--------|------|
+  | loadUsers() | - | async | 加载用户列表 |
+  | deleteUser(_:) | UserVO | async | 删除用户 |
+  | searchUsers(_:) | String | - | 搜索过滤 |
+- **依赖**: UserRepository（网络请求）, UserCacheService（本地缓存）
+```
+
+### 层 4: Model / Entity 层
+
+**扫描文件**: `Models/**/*.swift`, `Entities/**/*.swift`
+
+**提取内容**:
+- struct / class 名 + 遵循的协议（Codable, Identifiable, Hashable）
+- 属性列表（名称 + 类型 + 编码键）
+- 关联模型（嵌套结构体、关联关系）
+
+**输出示例**:
+```
+### User
+- **路径**: `Models/User.swift`
+- **类型**: struct, Codable, Identifiable
+- **属性**:
+  | 属性 | 类型 | CodingKey | 说明 |
+  |------|------|-----------|------|
+  | id | String | "id" | 唯一标识 |
+  | name | String | "name" | 用户名 |
+  | email | String | "email" | 邮箱 |
+  | avatar | URL? | "avatar_url" | 头像 |
+  | createdAt | Date | "created_at" | 注册时间 |
+```
+
+### 层 5: Service / Repository 层
+
+**扫描文件**: `Services/**/*.swift`, `Network/**/*.swift`, `Repositories/**/*.swift`
+
+**提取内容**:
+- 协议定义（方法签名）
+- 实现类（网络层使用 Alamofire / URLSession）
+- API 端点映射
+- 请求/响应模型
+- 错误处理策略
+
+**输出示例**:
+```
+### UserRepository
+- **协议文件**: `Repositories/UserRepositoryProtocol.swift`
+- **实现文件**: `Repositories/UserRepository.swift`
+- **API 方法**:
+  | 方法 | HTTP | 路径 | 参数 | 返回类型 |
+  |------|------|------|------|----------|
+  | getUsers(page:limit:) | GET | /api/users | page, limit | Result<[User], APIError> |
+  | getUser(id:) | GET | /api/users/:id | id | Result<User, APIError> |
+  | createUser(_:) | POST | /api/users | UserCreateDTO | Result<User, APIError> |
+```
+
+### 层 6: 响应式链分析（RxSwift / Combine）
+
+**扫描文件**: 含 `Observable`, `Publisher`, `Driver`, `Signal` 的文件
+
+**提取内容**:
+- 响应式链的输入/输出
+- 操作符链（map, flatMapLatest, filter, debounce 等）
+- 线程调度（MainScheduler, DispatchQueue.main）
+- DisposeBag / cancel 管理
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {项目名}
+
+## 项目概述
+App 功能描述 + 目标用户 + 核心价值
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| Swift | 5.9 | 开发语言 |
+| UIKit + SwiftUI | iOS 17+ | UI 框架 |
+| Combine | - | 响应式 |
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+用户操作 → ViewController → ViewModel → Repository → API → 解码 → Model → ViewModel → UI 更新
+
+## 目录结构
+按 Feature 模块组织的文件树
+
+## 导航结构
+Coordinator 层级 + 页面流转图
+
+## 模块详解
+按 Feature 分组，每个包含 View/ViewModel/Model/Service
+
+## 依赖管理
+SPM / CocoaPods 依赖列表
+
+## 构建 & 部署
+Xcode 版本 + Certificate + Scheme
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 页面/视图层 | `Sources/{Module}/`, `Screens/` | 每个子目录 | 目录名 kebab-case |
+| API/服务层 | `Services/`, `Network/` | 每个子目录 | 目录名 kebab-case |
+| 状态管理层 | `ViewModels/`, `Stores/` | 每个子目录或文件 | 名称 kebab-case |
+| 组件层 | `Views/`, `UIComponents/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| 扩展层 | `Extensions/` | 所有文件合并 | extensions |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `App.swift`, `main.swift`）
+- 纯导出桶文件（仅有 re-export）
+- 工具函数目录（`Utils/`, `Helpers/`）— 合并为一个模块
+- 生成文件（`*.generated.swift`）跳过
+
+## Token 管理
+
+- 大模块（>20 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- Storyboard / XIB 文件跳过（二进制格式）
+- Assets.xcassets 只分析目录结构，不分析图片内容
+- Package.swift / Podfile 依赖分析单独一个子任务
+- 生成的文件（`*.generated.swift`, `*.xcassets` 详情）跳过

package/skills/project-analyze/rules/python.md

@@ -0,0 +1,317 @@
+# Python 项目分析规则
+
+## 分析粒度
+
+按应用模块和框架分层架构进行分析。支持 Django / FastAPI / Flask / 纯 Python 项目。
+
+```
+Application Entry (manage.py / main.py / app.py)
+    ↓
+Router / URL Configuration（路由）
+    ↓
+Views / Handlers（视图/处理器）
+    ↓
+Services / Use Cases（业务逻辑）
+    ↓
+Models / Schemas（数据模型）
+    ↓
+Repositories / DAL（数据访问）
+    ↓
+Config / Settings（配置）
+    ↓
+Middleware / Guards（中间件）
+```
+
+## 目录扫描策略
+
+### 1. 识别框架类型
+
+**信号文件检测：**
+- Django: `manage.py` + `settings.py` + `*/urls.py`
+- FastAPI: `main.py` 中 `from fastapi import FastAPI`
+- Flask: `app.py` / `application.py` 中 `from flask import Flask`
+- 纯 Python: 无框架特征，按包结构分析
+
+### 2. 识别项目结构
+
+- `pyproject.toml` / `setup.py` → 包项目
+- `requirements.txt` / `Pipfile` → 依赖管理
+- `Dockerfile` → 容器化部署
+
+### 3. 依赖提取
+
+从 `pyproject.toml` / `requirements.txt` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| Web 框架 | django, fastapi, flask, starlette |
+| ASGI | uvicorn, hypercorn, daphne |
+| ORM | sqlalchemy, django-orm, tortoise-orm, prisma |
+| 数据验证 | pydantic, marshmallow |
+| 数据库驱动 | psycopg2, pymysql, asyncpg, redis |
+| 认证 | python-jose, passlib, pyjwt |
+| 任务队列 | celery, arq, huey |
+| 测试 | pytest, httpx, factory-boy |
+| 代码质量 | mypy, ruff, black, isort |
+
+### 4. 按框架分层扫描
+
+#### Django
+
+- **URL 配置**: `*/urls.py`
+- **Views**: `*/views.py`, `*/views/`
+- **Models**: `*/models.py`, `*/models/`
+- **Serializers**: `*/serializers.py`
+- **Admin**: `*/admin.py`
+- **Forms**: `*/forms.py`
+- **Middleware**: `*/middleware.py`
+- **Management Commands**: `*/management/commands/`
+- **Templates**: `*/templates/`
+- **Tests**: `*/tests/`, `tests.py`
+
+#### FastAPI
+
+- **Routers**: `*/routers/`, `*/routes/`, `*/api/`
+- **Schemas**: `*/schemas.py`, `*/models.py`
+- **Services**: `*/services/`, `*/crud.py`
+- **Dependencies**: `*/dependencies.py`
+- **Config**: `*/config.py`, `core/config.py`
+- **Middleware**: `*/middleware.py`
+
+#### Flask
+
+- **Routes**: `*/routes.py`, `*/views.py`
+- **Blueprints**: `*/blueprints/`
+- **Models**: `*/models.py`
+- **Templates**: `*/templates/`
+- **Extensions**: `*/extensions.py`
+
+## 各层提取规则
+
+### 层 1: 路由层
+
+**扫描文件**: `urls.py` (Django), `routers/*.py` (FastAPI), `routes.py` (Flask)
+
+**提取内容**:
+- 路由配置（HTTP 方法 + 路径 + 处理函数）
+- 路由分组（Router prefix, Blueprint name）
+- URL 参数类型
+- 中间件应用
+
+**输出示例**:
+```
+### API 路由结构（FastAPI）
+- **文件**: `app/api/__init__.py`
+- **Router 前缀**: /api/v1
+- **路由分组**:
+  | 前缀 | Router | 处理文件 | 标签 |
+  |------|--------|----------|------|
+  | /auth | auth_router | routers/auth.py | 认证 |
+  | /users | users_router | routers/users.py | 用户管理 |
+  | /items | items_router | routers/items.py | 物品管理 |
+- **端点列表**:
+  | 方法 | 路径 | 处理函数 | 认证 | 说明 |
+  |------|------|----------|------|------|
+  | POST | /auth/login | login | 否 | 登录获取 token |
+  | POST | /auth/register | register | 否 | 注册 |
+  | GET | /users/me | get_current_user | JWT | 获取当前用户 |
+  | GET | /users/{user_id} | get_user | JWT+Admin | 获取用户详情 |
+  | POST | /items/ | create_item | JWT | 创建物品 |
+```
+
+### 层 2: Views / Handlers 层
+
+**扫描文件**: `views.py`, `views/*.py` (Django), `routers/*.py` (FastAPI)
+
+**提取内容**:
+- 视图函数/类签名
+- 请求参数（路径参数 + 查询参数 + 请求体）
+- 响应模型
+- 依赖注入（FastAPI Depends）
+- 装饰器（`@login_required`, `@permission_required`, `@router.get`）
+
+**输出示例**:
+```
+### create_item（FastAPI Router）
+- **文件**: `app/api/routers/items.py`
+- **签名**:
+  ```python
+  @router.post("/", response_model=ItemResponse, status_code=201)
+  async def create_item(
+      item: ItemCreate,
+      current_user: User = Depends(get_current_user),
+      db: AsyncSession = Depends(get_db),
+  ) -> ItemResponse:
+  ```
+- **依赖注入**:
+  | 参数 | 来源 | 说明 |
+  |------|------|------|
+  | item | Request Body (ItemCreate) | 创建物品的数据 |
+  | current_user | Depends(get_current_user) | JWT 认证 |
+  | db | Depends(get_db) | 数据库会话 |
+- **响应**: ItemResponse (201 Created)
+- **异常**: 401 Unauthorized, 422 Validation Error
+```
+
+### 层 3: Models / Schemas 层
+
+**扫描文件**: `models.py`, `schemas.py`, `models/*.py`
+
+#### SQLAlchemy / Tortoise ORM
+
+**输出示例**:
+```
+### User (SQLAlchemy Model)
+- **路径**: `app/models/user.py`
+- **表名**: users
+- **字段**:
+  | 字段 | 类型 | 约束 | 说明 |
+  |------|------|------|------|
+  | id | Integer | PK, autoincrement | 主键 |
+  | email | String(255) | unique, not null | 邮箱 |
+  | hashed_password | String(255) | not null | 密码哈希 |
+  | is_active | Boolean | default=True | 是否激活 |
+  | created_at | DateTime | default=now() | 创建时间 |
+- **关系**:
+  | 关系 | 类型 | 目标 | 反向引用 |
+  |------|------|------|----------|
+  | items | one-to-many | Item | owner |
+```
+
+#### Pydantic Schemas
+
+**输出示例**:
+```
+### ItemCreate (Pydantic Schema)
+- **路径**: `app/schemas/item.py`
+- **字段**:
+  | 字段 | 类型 | 约束 | 说明 |
+  |------|------|------|------|
+  | title | str | min_length=1, max_length=100 | 物品标题 |
+  | description | str \| None | default=None | 描述 |
+  | price | float | gt=0 | 价格 |
+- **Config**: from_attributes = True (ORM mode)
+```
+
+### 层 4: Service / CRUD 层
+
+**扫描文件**: `services/*.py`, `crud.py`
+
+**提取内容**:
+- Service 类/函数签名
+- CRUD 操作（增删改查方法）
+- 业务逻辑摘要
+- 依赖的其他 Service / Repository
+
+**输出示例**:
+```
+### ItemService
+- **路径**: `app/services/item_service.py`
+- **依赖**: ItemRepository, CategoryService
+- **方法**:
+  | 方法 | 签名 | 说明 |
+  |------|------|------|
+  | create_item | (db, item_data, user_id) → Item | 创建物品，校验分类存在 |
+  | get_item | (db, item_id) → Item \| None | 获取物品详情 |
+  | list_items | (db, skip, limit, filters) → list[Item] | 分页查询 |
+  | delete_item | (db, item_id, user_id) → bool | 删除（仅所有者） |
+```
+
+### 层 5: 认证/安全层
+
+**扫描文件**: `auth/*.py`, `core/security.py`, `core/config.py`
+
+**提取内容**:
+- 认证方式（JWT / Session / OAuth2）
+- Token 生成/验证逻辑
+- 密码哈希方式
+- 权限检查机制
+
+**输出示例**:
+```
+### 认证配置
+- **文件**: `app/core/security.py`
+- **Token**: JWT (HS256)
+  - 过期时间: 30 分钟 (access_token)
+  - 密钥: settings.SECRET_KEY
+- **密码**: bcrypt (passlib)
+- **OAuth2**: FastAPI OAuth2PasswordBearer
+- **权限**: role-based (admin / user)
+```
+
+### 层 6: 中间件层
+
+**扫描文件**: `middleware.py`, `app/middleware/*.py`
+
+**输出示例**:
+```
+### 中间件链
+| 顺序 | 中间件 | 用途 |
+|------|--------|------|
+| 1 | CORSMiddleware | 跨域处理 |
+| 2 | RequestTimingMiddleware | 请求计时 |
+| 3 | AuthMiddleware | Token 解析（非 JWT 路由跳过） |
+| 4 | RateLimitMiddleware | 限流 |
+```
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {项目名}
+
+## 项目概述
+系统功能描述
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+请求 → Middleware → Router → Handler → Service → Repository → DB
+
+## API 接口文档
+按模块分组的端点表
+
+## 数据模型
+ORM 模型关系图
+
+## 认证与权限
+认证流程 + 权限模型
+
+## 配置说明
+环境变量 + 配置文件
+
+## 构建 & 部署
+Docker + 命令
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| Django Apps | 每个 Django app 目录 | 独立模块 | app 名 kebab-case |
+| FastAPI Routers | `app/routers/` | 每个文件或子目录 | 路由前缀 kebab-case |
+| API 层 | `app/api/`, `app/routers/` | 每个子目录 | 目录名 kebab-case |
+| 模板层 | `app/templates/` | 每个子目录 | 目录名 kebab-case |
+| 数据模型层 | `app/models.py` | 按类分组 | 类名 kebab-case |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `main.py`, `app.py`, `manage.py`）
+- 纯导出桶文件（`__init__.py` 仅有 import）
+- 工具函数目录（`utils/`, `helpers/`）— 合并为一个模块
+- `__pycache__/`, `.venv/` 跳过
+
+## Token 管理
+
+- 大模块（>15 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- `requirements.txt` / `pyproject.toml` 依赖分析单独一个子任务
+- 迁移文件（`migrations/`, `alembic/versions/`）跳过分析
+- 测试文件单独分析
+- `__pycache__/`, `.venv/` 跳过