@dtt_siye/atool 1.1.0

package/skills/project-analyze/prompts/code-review-agent.md

@@ -0,0 +1,122 @@
+# Phase 4 Code Review Sub-Agent Prompt Template
+
+> For full phase context, read `phases/phase4-code-quality.md`
+
+---
+
+## Prompt Template
+
+```
+## 任务
+对模块「{module_name}」执行代码质量审查，生成审查报告。
+
+## 输出语言
+所有文档**必须中文**。
+例外（保持英文）：代码块、文件路径、技术标识符。
+
+## 输入数据
+### Inventory（来自 Phase 1）
+{inventory_json}
+
+### 知识图谱上下文（来自 Phase 3）
+{relevant_graph_subtree}
+
+### v5.0 多维分析上下文（如果存在）
+{multi_dimensional_context}
+
+### Pre-Scan 基线指标（来自 Phase 0.5）
+{pre_computed_metrics}
+
+> 包含：长函数列表（>50行）、未使用 import 候选、嵌套深度估算、API 端点安全检查清单
+> 这些指标由 grep/awk 自动提取，可作为审查基线——直接使用，无需重新提取。
+
+### 源文件
+仅读取 pre-scan 标记为 confidence: "low" 的文件 + 审查基线中发现问题的文件：
+{file_list}
+
+> 对于 confidence: "high" 且基线指标正常的文件，信任 pre-scan 数据，无需全文读取。
+
+## 审查维度（8 个）
+
+### 维度 1: 代码质量 (权重 0.15)
+- 圈复杂度（阈值：函数 >10 为 warning，>20 为 critical）
+- 函数长度（阈值：>50 行 warning，>100 行 critical）— 参考 pre-scan 基线
+- 嵌套深度（阈值：>3 层 warning，>5 层 critical）— 参考 pre-scan 基线
+- 注释率（阈值：<10% warning）
+- 参数数量（阈值：>4 个 warning）
+
+### 维度 2: 死代码 (权重 0.10)
+- 未使用函数/import — 参考 pre-scan 未使用 import 候选列表
+- 不可达代码
+- 无引用的变量/常量
+
+### 维度 3: 重复代码 (权重 0.10)
+- 相似代码块（>6 行，>80% 相似）
+- 函数体重复
+- 抽象不足导致的模式重复
+
+### 维度 4: 错误/安全 (权重 0.20)
+- 空 catch 块
+- SQL 注入风险
+- 硬编码凭证
+- 未验证的用户输入
+- 敏感数据暴露
+- API 端点安全检查 — 参考 pre-scan API 端点清单
+
+### 维度 5: 架构合规 (权重 0.15)
+- 分层违反（UI 直接调用 DAO）
+- 依赖方向（外层不应依赖内层）
+- DDD 合规
+- 包结构合理性
+{multi_dimensional_architecture_hints}
+
+### 维度 6: 可维护性 (权重 0.10)
+- SQALE 修复工作量估算
+- MI 指数
+- 代码异味检测
+{multi_dimensional_maintainability_hints}
+
+### 维度 7: 耦合内聚 (权重 0.10)
+- Ca/Ce/Instability 指标
+- 循环依赖检测
+- CK Metrics（WMC/DIT/NOC/CBO/RFC/LCOM）
+- DSM 分析
+
+### 维度 8: 技术债务 (权重 0.10)
+- 已废弃 API 使用
+- TODO 老化（>30 天未解决）
+- 过时模式/框架版本
+- 缺失的测试覆盖
+
+## 评分计算
+file_score = Σ(dimension_score × dimension_weight)
+project_score = weighted_avg(file_scores, weight=file_lines)
+健康等级: 0-20 健康 | 20-40 一般 | 40-60 需关注 | 60-80 较差 | 80-100 严重
+
+## 输出（JSON）
+{
+  "module": "{module-slug}",
+  "score": 35,
+  "health_level": "需关注",
+  "dimensions": {
+    "quality": { "score": 30, "issues": [...] },
+    "dead-code": { "score": 15, "issues": [...] },
+    "duplication": { "score": 25, "issues": [...] },
+    "error-security": { "score": 40, "issues": [...] },
+    "architecture": { "score": 35, "issues": [...] },
+    "maintainability": { "score": 30, "issues": [...] },
+    "coupling-cohesion": { "score": 20, "issues": [...] },
+    "deprecation-debt": { "score": 25, "issues": [...] }
+  },
+  "top_issues": [],
+  "refactoring_suggestions": [
+    { "name": "...", "current": "...", "target": "...", "effort": "2h" }
+  ]
+}
+
+## 禁止行为
+- 禁止使用通用建议替代实际代码分析
+- 禁止将环境变量标记为硬编码凭证（除非明显是密码/密钥）
+- 禁止遗漏任何维度（即使评分为 0 也必须输出）
+- 禁止对 confidence: "high" 且基线正常的文件做重复结构分析
+```

package/skills/project-analyze/prompts/deep-analysis-agent.md

@@ -0,0 +1,107 @@
+# Phase 2 Deep Analysis Sub-Agent Prompt Template
+
+> For full phase context, read `phases/phase2-deep-analysis.md`
+
+---
+
+## Prompt Template
+
+```
+## 任务
+深度分析模块「{module_name}」，生成 MODULE-DOC.md + analysis.json。
+
+## 已有数据（来自 Phase 1 inventory + Phase 0.5 pre-scan）
+
+### Pre-Scan 结构摘要（紧凑表格）
+{prescan_summary_content}
+
+> 已提取信息：imports, exports, classes, functions, decorators, api_endpoints, data_models
+> 无需重复读取以下结构信息，直接使用。
+
+### Inventory 语义注释
+{inventory_semantic_content}
+
+### 源文件读取策略
+- 小文件（<100 行）：{small_files_list} — 已嵌入 pre-scan 数据，可直接使用
+- 中文件（100-500 行）：{medium_files_list} — 读取全文进行深度分析
+- 大文件（>500 行）：{large_files_list} — 仅读取 pre-scan 标记的关键区域（函数体、类定义）
+- confidence: "low" 文件：{low_confidence_files} — 必须全文读取验证
+
+## 技术栈规则
+{rules_content}
+
+## Zero-KT 原则
+所有文档满足「Zero-KT」标准：**新人仅凭文档即可独立完成以下任务，无需向任何人提问**：
+
+1. **理解项目**：为什么架构是这样设计的，每个模块为什么存在
+2. **添加功能**：知道在哪个文件、哪个层、按照什么模式添加
+3. **修复缺陷**：知道错误可能在哪个模块、如何调试、如何验证
+4. **理解业务**：知道核心业务术语、业务规则、数据含义
+
+**深度判断**：读者读完仍需问「为什么这样做」→ 不够深；仍需问「怎么做」→ 不够具体；仍需问「这是什么意思」→ 缺术语解释。
+
+**三人测试**：文档必须通过——(1) 新入职开发者能理解 (2) 不看源码能操作 (3) 遇到问题有排查指引。
+
+## 输出语言
+所有文档**必须中文**（README.md、COMPONENT.md、UI_STYLE.md、CODE_REVIEW.md、docs/、MODULE-DOC.md、ASCII 图标注）。
+例外（保持英文）：代码块、文件路径、技术标识符（变量/函数/类名）、API 路径、包名、Git 分支名。
+
+## 项目上下文
+- 技术栈: {stack}
+- 项目名: {project_name}
+- 已识别模块: {module_list}
+
+## 必须注入的项目真实数据
+- 实际包路径/导入路径（从 pre-scan 提取，禁止使用 com/example/ 等默认值）
+- 实际版本号（从配置文件提取，禁止编造）
+- 实际依赖列表（从 pre-scan 提取）
+
+## 输出要求
+
+### 文件 1: MODULE-DOC.md（写入 .atool-docs/modules/{module-slug}/MODULE-DOC.md）
+
+必须包含 11 项：
+1. 模块业务职责（具体描述，禁止套话）
+2. 核心类/组件清单（名称+路径+一句话描述）
+3. 公开 API 完整签名表
+4. 依赖关系（上游+下游）
+5. 数据流 ASCII 图
+6. 业务术语表（术语/英文标识/含义/使用场景/源码位置）
+7. 设计决策记录（ADR格式：决策/选择/替代方案/理由/权衡）
+8. 常见开发场景（3-5个，含 step-by-step + 完整代码示例）
+9. 故障排查指南（按症状组织：症状/可能原因/排查步骤/解决方案）
+10. 关联模块交互（关联模块/交互方式/交互场景/文档链接）
+11. 错误处理策略（错误类型/处理方式/用户提示/日志记录）
+
+### 文件 2: analysis.json（写入 .atool-docs/modules/{module-slug}/analysis.json）
+
+{
+  "module": "{module-slug}",
+  "business_domain": "用户管理",
+  "responsibility": "管理用户的增删改查、角色分配、状态管理",
+  "design_intent": "作为系统核心业务模块，封装用户生命周期管理",
+  "key_entities": ["User", "UserRole", "Role"],
+  "public_api": [
+    { "name": "fetchUsers", "signature": "(params: UserQuery): Promise<Page<User>>", "callers": ["UserList.vue"] }
+  ],
+  "data_flows": [
+    { "trigger": "用户点击搜索", "path": "UserList → useUserStore.search() → api/user.ts → GET /api/users", "output": "用户列表数据" }
+  ],
+  "business_terms": [
+    { "term": "审批流", "identifier": "approval_flow", "meaning": "多级审批的流程定义", "source": "workflow.ts" }
+  ]
+}
+
+## 禁止行为
+- 禁止使用未替换的模板占位符（com/example/、{{PROJECT_NAME}}、xxx、TODO、...）
+- 禁止使用通用建议替代实际分析结果
+- 禁止输出纯文件列表或无信息条目
+- 禁止重新提取 pre-scan 已包含的结构信息（直接引用即可）
+
+## 深度级别追加指令
+{depth_specific_instructions}
+```
+
+### Depth-Specific Instructions
+
+For depth level specific instructions to append, see `phases/phase2-deep-analysis.md` section 2.2b (L1/L2/L3/L4/L5 追加指令).

package/skills/project-analyze/prompts/inventory-agent.md

@@ -0,0 +1,67 @@
+# Phase 1 Inventory Sub-Agent Prompt Template
+
+> For full phase context, read `phases/phase1-inventory.md`
+
+---
+
+## Prompt Template
+
+```
+## 任务
+对模块「{module_name}」执行语义标注，基于 Phase 0.5 pre-scan 数据进行验证和语义增强。
+
+## 输出语言
+所有文档**必须中文**（标题、描述、注释）。
+例外（保持英文）：代码块、文件路径、技术标识符（变量/函数/类名）、API 路径、包名。
+
+## 已有数据（来自 Phase 0.5 Pre-Scan）
+{prescan_json_content}
+
+> pre-scan 已提取：imports, exports, classes, functions, decorators, api_endpoints, data_models
+> 以下文件标记为 confidence: "low"（需重点验证）：{low_confidence_files}
+
+## 你的任务（3 项）
+
+### 1. 验证 pre-scan 准确性
+仅读取 confidence: "low" 的文件，检查提取结果是否正确。对 confidence: "high" 的文件，信任 pre-scan 结果，不做重复读取。
+
+### 2. 添加语义注释
+为每个文件添加 pre-scan 无法提取的语义信息：
+- `module_business_domain`: 文件所属业务域（如"用户管理"、"订单处理"）
+- `semantic_purpose`: 文件的语义用途（一句话描述）
+- `component_type`: 页面/服务/工具/模型/配置 等
+- `ui_components`: 使用的 UI 框架组件（仅 UI 文件）
+
+### 3. 标记动态模式
+检测并标记 pre-scan 可能遗漏的：
+- 动态 import（`import()` 表达式）
+- 元编程（装饰器工厂、反射）
+- 运行时注册（plugin register、event listener）
+- 框架自动注入（Spring @Autowired, FastAPI Depends）
+
+## 输出格式（与现有 inventory JSON 完全一致，向后兼容）
+{
+  "module": "{module-slug}",
+  "files": [
+    {
+      "path": "src/views/user/UserList.vue",
+      "imports": ["vue", "pinia", "@/api/user"],
+      "exports": ["default"],
+      "functions": ["fetchUsers(params): Promise<PageResult>", "handleEdit(row): void"],
+      "classes": [],
+      "components_used": ["ElTable", "ElPagination", "UserFormDialog"],
+      "file_level_comment": "用户列表页面，含搜索/分页/CRUD弹窗",
+      "semantic_purpose": "用户管理列表页面，提供搜索、分页、增删改查功能",
+      "module_business_domain": "用户管理",
+      "component_type": "page",
+      "extraction_confidence": "high"
+    }
+  ]
+}
+
+## 禁止行为
+- 禁止读取 confidence: "high" 的文件（浪费 token，结果已在 pre-scan 中）
+- 禁止使用未替换的模板占位符
+- 禁止输出纯文件列表或无信息条目
+- 禁止遗漏任何 pre-scan 已识别的文件
+```

package/skills/project-analyze/prompts/l4-analysis-agent.md

@@ -0,0 +1,98 @@
+# Phase 2a L4 Analysis Sub-Agent Prompt Template
+
+> For full phase context, read `phases/phase2a-l4-analysis.md`
+
+---
+
+## Prompt Template
+
+```
+## 任务
+对模块「{module_name}」的每个函数进行 L4 级别分析，生成 l4-analysis.json。
+
+## 输出语言
+所有文档**必须中文**。
+例外（保持英文）：代码块、文件路径、技术标识符。
+
+## Zero-KT 原则
+所有文档满足「Zero-KT」标准：**新人仅凭文档即可独立完成任务，无需向任何人提问**。
+
+## 已有数据
+
+### Phase 2 analysis.json
+{analysis_json_content}
+
+### Phase 0.5 Pre-Scan 函数表（已提取的调用关系和行范围）
+{prescan_function_table}
+
+> pre-scan 已提取：函数名、参数、行范围、caller/callee 关系、装饰器
+> 利用这些数据定向读取函数体，无需全文扫描。
+
+### Phase 1 inventory
+{inventory_json_content}
+
+### 源文件读取策略
+使用 pre-scan 提供的行范围，仅读取目标函数体（而非整个文件）：
+{file_line_ranges}
+
+格式：path:start-end — 仅读取指定行范围进行深度分析。
+
+## L4 分析要求
+
+对每个函数（不仅公开函数）执行以下分析：
+
+1. **调用链追踪**：验证 pre-scan 提取的 caller → current → callee 链（跨文件追踪，最多 3 层）
+   - 确认 pre-scan 的调用关系是否正确
+   - 补充 pre-scan 无法检测的动态调用（反射、回调、事件驱动）
+2. **性能热点识别**：
+   - 循环内的 I/O 操作（网络请求、文件读取、数据库查询）
+   - O(n²) 及以上复杂度算法
+   - 重复计算 / 缓存机会
+   - 大对象创建/复制
+3. **安全审计点**：
+   - 用户输入处理路径（从入口到存储/输出）
+   - SQL/命令拼接点
+   - 认证/授权检查缺失
+   - 敏感数据暴露（日志、错误消息、响应体）
+4. **数据流路径**：
+   - 每个函数的输入数据来源（参数、全局状态、外部调用）
+   - 数据变换步骤（mutation/transformation）
+   - 输出数据去向（返回值、副作用、状态变更）
+
+## 输出（JSON）
+
+写入 `.atool-docs/modules/{module-slug}/l4-analysis.json`：
+
+{
+  "module": "{module-slug}",
+  "functions": [
+    {
+      "name": "processOrder",
+      "file": "src/services/order.ts",
+      "line_range": [45, 112],
+      "callers": ["OrderController.create", "BatchProcessor.run"],
+      "callees": ["validateOrder", "calculateTotal", "saveOrder", "notifyUser"],
+      "complexity": 8,
+      "hotspots": [
+        { "type": "N+1_query", "line": 78, "severity": "warning", "description": "循环内调用 getUserById" }
+      ],
+      "security_points": [
+        { "type": "input_validation", "line": 49, "status": "present", "description": "订单数据校验" }
+      ],
+      "data_flow": {
+        "inputs": ["params: CreateOrderDTO", "ctx.user (implicit)"],
+        "transforms": ["validate → enrich → calculate → persist"],
+        "outputs": ["return Order entity", "side-effect: notifyUser()"]
+      }
+    }
+  ],
+  "hotspot_summary": { "total": 5, "critical": 1, "warning": 4 },
+  "security_summary": { "total": 8, "issues": 2, "mitigated": 6 }
+}
+
+## 禁止行为
+- 禁止编造不存在的函数或调用关系
+- 禁止使用通用性能建议替代实际分析结果
+- 禁止遗漏任何可见函数（包括 private/internal）
+- 禁止重新提取 pre-scan 已包含的结构信息（直接引用验证即可）
+```

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

@@ -0,0 +1,282 @@
+# Android / Kotlin 项目分析规则
+
+## 分析粒度
+
+按 Feature Module 和 MVVM+ 分层架构进行分析。
+
+```
+Application (Application 类)
+    ↓
+DI Module（依赖注入：Hilt / Koin）
+    ↓
+Navigation（导航：Jetpack Navigation / Compose Navigation）
+    ↓
+Activity / Fragment / Composable Screen
+    ↓
+ViewModel
+    ↓
+Repository
+    ↓
+Data Source（Remote: Retrofit + Local: Room / DataStore）
+    ↓
+Model / Entity（数据模型）
+```
+
+## 目录扫描策略
+
+### 1. 识别项目类型
+
+**信号文件检测：**
+- 单模块: `app/` 下直接包含源码
+- 多模块: `settings.gradle` 中 `include` 列表
+- Compose 项目: `build.gradle` 中 `compose = true`
+- KMP 项目: `shared/` 模块 + `build.gradle.kts`
+
+### 2. 识别架构模式
+
+- **MVVM + Repository**: ViewModel + Repository + Room
+- **MVI**: Intent → Reducer → State → View
+- **Clean Architecture**: Domain / Data / Presentation 三层
+
+### 3. 依赖提取
+
+从 `build.gradle` / `build.gradle.kts` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| Compose | compose-bom, compose-ui, compose-material3 |
+| Navigation | navigation-compose, navigation-fragment |
+| DI | hilt-android, koin-android |
+| 网络 | retrofit, okhttp, ktor |
+| 图片 | coil-compose, glide |
+| 数据库 | room-runtime, datastore-preferences |
+| 异步 | kotlinx-coroutines, rxjava |
+| 序列化 | kotlin-serialization, moshi, gson |
+| DI | hilt-android-compiler, koin |
+| 测试 | junit, mockk, turbine |
+
+### 4. 按层扫描路径
+
+- **UI 层**: `*/ui/`, `*/screens/`, `*/compose/`
+- **Activity/Fragment**: `*/activities/`, `*/fragments/`
+- **ViewModel**: `*/viewmodel/`, `*/viewmodels/`
+- **Repository**: `*/repository/`, `*/repositories/`
+- **数据源**: `*/data/remote/`, `*/data/local/`, `*/datasource/`
+- **Model**: `*/model/`, `*/models/`, `*/entity/`
+- **DI**: `*/di/`, `*/hilt/`
+
+## 各层提取规则
+
+### 层 1: UI 层
+
+#### Jetpack Compose
+
+**扫描文件**: `*Screen.kt`, `*Page.kt`, 含 `@Composable` 的文件
+
+**提取内容**:
+- `@Composable` 函数签名 + 参数
+- `Modifier` 链
+- 状态管理（`remember`, `mutableStateOf`, `collectAsState`）
+- 子 Composable 结构（1-2 层）
+- `@Preview` 注解
+
+**输出示例**:
+```
+### UserListScreen
+- **路径**: `ui/screens/user/UserListScreen.kt`
+- **签名**:
+  ```kotlin
+  @Composable
+  fun UserListScreen(
+      navController: NavController,
+      viewModel: UserListViewModel = hiltViewModel()
+  )
+  ```
+- **状态收集**:
+  | State | 来源 | 用途 |
+  |-------|------|------|
+  | users | viewModel.users.collectAsState() | 用户列表 |
+  | isLoading | viewModel.isLoading.collectAsState() | 加载状态 |
+  | searchQuery | viewModel.searchQuery.collectAsState() | 搜索关键词 |
+- **UI 结构**:
+  Scaffold(topBar = UserListTopBar(), floatingActionButton = AddUserFAB())
+    → LazyColumn(items = users)
+      → UserListItem(user, onClick = { nav to detail })
+- **Modifier 链**: Modifier.fillMaxSize().padding(16.dp)
+```
+
+#### XML Layout
+
+**扫描文件**: `res/layout/*.xml`
+
+**提取内容**:
+- Layout 层级结构
+- include / merge 标签
+- 自定义 View
+
+### 层 2: ViewModel 层
+
+**扫描文件**: `*ViewModel.kt`
+
+**提取内容**:
+- ViewModel 类名 + 构造参数（`@AssistedInject`）
+- UI State 数据类（字段 + 类型）
+- Action / Intent（用户操作）
+- Effect / Event（一次性事件）
+- 依赖的 Repository
+
+**输出示例**:
+```
+### UserListViewModel
+- **路径**: `ui/screens/user/UserListViewModel.kt`
+- **注入**: @HiltViewModel
+- **UI State**:
+  ```kotlin
+  data class UserListState(
+      val users: List<UserVO> = emptyList(),
+      val isLoading: Boolean = false,
+      val searchQuery: String = "",
+      val error: String? = null
+  )
+  ```
+- **Actions**:
+  | Action | 参数 | 说明 |
+  |--------|------|------|
+  | loadUsers | - | 初始加载 |
+  | searchUsers | query: String | 搜索过滤 |
+  | deleteUser | userId: Long | 删除用户 |
+  | refresh | - | 下拉刷新 |
+- **Effects**:
+  | Effect | 载荷 | 说明 |
+  |--------|------|------|
+  | NavigateToDetail | userId: Long | 导航到详情 |
+  | ShowToast | message: String | 显示提示 |
+- **依赖**: UserRepository
+```
+
+### 层 3: Repository 层
+
+**扫描文件**: `*Repository.kt`
+
+**输出示例**:
+```
+### UserRepository
+- **路径**: `data/repository/UserRepositoryImpl.kt`
+- **接口**: `domain/repository/UserRepository.kt`
+- **数据源**: UserRemoteDataSource, UserLocalDataSource (Room)
+- **方法**:
+  | 方法 | 签名 | 说明 |
+  |------|------|------|
+  | getUsers | suspend () → List<User> | 先本地后远程 |
+  | getUserById | suspend (Long) → User | 查询详情 |
+  | saveUsers | suspend (List<User>) → Unit | 缓存到本地 |
+```
+
+### 层 4: Room 数据库分析
+
+**扫描文件**: `*Entity.kt`, `*Dao.kt`, `*Database.kt`
+
+**输出示例**:
+```
+### AppDatabase
+- **文件**: `data/local/AppDatabase.kt`
+- **版本**: 3
+- **Entities**: UserEntity, SettingsEntity
+- **Dao**:
+  | Dao | 方法 | 返回类型 |
+  |-----|------|----------|
+  | UserDao | getAllUsers() | Flow<List<UserEntity>> |
+  | UserDao | getUserById(id) | Flow<UserEntity?> |
+  | UserDao | insertUsers(users) | List<Long> |
+  | UserDao | deleteUser(id) | Int |
+- **Migration**: 2→3 (添加 avatar 字段)
+```
+
+### 层 5: DI 分析
+
+**扫描文件**: `*Module.kt` (Hilt), `*Module.kt` (Koin)
+
+**输出示例**:
+```
+### Hilt Modules
+| Module | Provides | Scope |
+|--------|----------|-------|
+| NetworkModule | OkHttpClient, Retrofit, ApiServices | Singleton |
+| DatabaseModule | AppDatabase, UserDAO | Singleton |
+| RepositoryModule | UserRepository | Singleton |
+```
+
+### 层 6: Navigation 分析
+
+**扫描文件**: `NavGraph.kt`, 含 `NavHost` 的文件
+
+**输出示例**:
+```
+### 导航图
+| 路由 | 目标 | 参数 | 动画 |
+|------|------|------|------|
+| user_list | UserListScreen | - | - |
+| user_detail | UserDetailScreen | userId: Long | slideInRight |
+| user_edit | UserEditScreen | userId: Long? | slideInRight |
+```
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {App 名称}
+
+## 项目概述
+App 功能描述
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+
+## 模块结构
+Gradle 模块依赖关系
+
+## 导航结构
+路由表 + 参数
+
+## 数据模型
+Entity + DTO + UI State
+
+## DI 配置
+Hilt / Koin 模块
+
+## 构建 & 部署
+Gradle 命令 + 变体
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| UI 层 | `app/src/main/java/**/ui/`, `app/src/main/java/**/screens/` | 每个子目录 | 目录名 kebab-case |
+| Repository 层 | `app/src/main/java/**/repository/` | 每个子目录 | 目录名 kebab-case |
+| ViewModel 层 | `app/src/main/java/**/viewmodel/` | 每个子目录 | 目录名 kebab-case |
+| 组件层 | `app/src/main/java/**/components/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| 数据模型层 | `app/src/main/java/**/model/` | 每个文件 | 文件名去后缀 kebab-case |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `MainActivity.kt`, `Application.kt`）
+- 纯导出桶文件（仅有 re-export）
+- 工具函数目录（`util/`, `helper/`, `extension/`）— 合并为一个模块
+- 生成文件（`*.generated.kt`, `BuildConfig`）跳过
+
+## Token 管理
+
+- 大模块（>20 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- `build.gradle` 依赖分析单独一个子任务
+- layout XML / Compose 文件单独分组分析
+- 生成文件（`*.generated.kt`, `BuildConfig`）跳过
+- 测试文件（`androidTest/`, `test/`）单独分析