# 多功能Android应用智能体 - 提示词文档

## 📋 项目概述

创建一个智能Agent，能够帮助开发者快速生成、优化和调试Android应用。该Agent应该能够理解开发需求，提供代码生成、架构建议、性能优化、问题诊断等多方面的支持。

## 🎯 核心功能需求

### 1. 需求分析与理解
- **输入**: 用户描述的应用需求（自然语言）
- **输出**: 结构化的需求分析结果
  - 应用类型（工具类、社交类、电商类等）
  - 核心功能模块
  - 技术栈建议
  - 复杂度评估
  - 开发周期估算

### 2. 架构设计建议
- **功能**: 根据需求生成Android应用架构方案
- **输出内容**:
  - 架构模式（MVP、MVVM、MVI等）
  - 模块划分
  - 技术选型（框架、库、工具）
  - 目录结构建议
  - 依赖管理方案

### 3. 代码生成
- **功能**: 生成Android应用的核心代码
- **支持类型**:
  - Activity/Fragment代码
  - ViewModel代码
  - Repository代码
  - Adapter代码
  - 网络请求代码（Retrofit）
  - 数据库代码（Room）
  - 布局XML文件
  - 资源文件（strings.xml、colors.xml等）

### 4. 性能优化建议
- **功能**: 分析代码并提供性能优化建议
- **优化方向**:
  - 内存优化
  - 启动速度优化
  - 网络请求优化
  - 图片加载优化
  - 布局渲染优化
  - 电量消耗优化

### 5. 问题诊断与修复
- **功能**: 分析错误日志，提供解决方案
- **支持场景**:
  - 崩溃分析（Crash Log）
  - ANR问题诊断
  - 内存泄漏检测
  - 网络请求失败
  - 权限问题
  - 兼容性问题

### 6. 最佳实践建议
- **功能**: 提供Android开发最佳实践
- **内容**:
  - 代码规范
  - 安全建议
  - 用户体验优化
  - 测试策略
  - 发布流程

## 🔄 工作流设计

### 工作流结构

```
开始节点 (start)
  ↓
需求理解与分析节点 (LLM)
  ↓
需求分类节点 (Condition)
  ├─→ [代码生成需求] → 代码生成节点 (LLM/Template)
  ├─→ [架构设计需求] → 架构设计节点 (LLM)
  ├─→ [问题诊断需求] → 问题诊断节点 (LLM)
  └─→ [性能优化需求] → 性能优化节点 (LLM)
         ↓                    ↓              ↓              ↓
         └─────────────────────────────────────────────────┘
                              ↓
                    结果整合节点 (Transform)
                              ↓
                    格式化输出节点 (LLM)
                              ↓
                    结束节点 (end)
```

### 详细节点配置

#### 1. 开始节点 (start-1)
```json
{
  "id": "start-1",
  "type": "start",
  "data": {
    "label": "开始",
    "description": "接收用户输入的Android开发需求"
  }
}
```

#### 2. 需求理解与分析节点 (llm-requirement-analysis)
```json
{
  "id": "llm-requirement-analysis",
  "type": "llm",
  "data": {
    "label": "需求理解与分析",
    "model": "deepseek-chat",
    "temperature": 0.3,
    "max_tokens": 2000,
    "prompt": "你是一个专业的Android开发顾问。请分析用户的需求，提取以下信息：\n1. 应用类型（工具类、社交类、电商类、游戏类等）\n2. 核心功能模块列表\n3. 目标用户群体\n4. 技术复杂度（简单/中等/复杂）\n5. 开发周期估算（周）\n6. 推荐的技术栈\n\n用户需求：{{user_query}}\n\n请以JSON格式输出分析结果：\n{\n  \"app_type\": \"应用类型\",\n  \"core_modules\": [\"模块1\", \"模块2\", ...],\n  \"target_users\": \"目标用户\",\n  \"complexity\": \"简单|中等|复杂\",\n  \"estimated_weeks\": 数字,\n  \"tech_stack\": [\"技术1\", \"技术2\", ...],\n  \"summary\": \"需求摘要\"\n}"
  }
}
```

#### 3. 需求分类节点 (condition-classify)
```json
{
  "id": "condition-classify",
  "type": "condition",
  "data": {
    "label": "需求分类",
    "condition": "{{input.complexity}}",
    "branches": [
      {
        "value": "代码生成",
        "condition": "包含'生成'、'创建'、'写代码'等关键词"
      },
      {
        "value": "架构设计",
        "condition": "包含'架构'、'设计'、'结构'等关键词"
      },
      {
        "value": "问题诊断",
        "condition": "包含'错误'、'崩溃'、'问题'、'bug'等关键词"
      },
      {
        "value": "性能优化",
        "condition": "包含'优化'、'性能'、'速度'、'卡顿'等关键词"
      }
    ]
  }
}
```

#### 4. 代码生成节点 (llm-code-generation)
```json
{
  "id": "llm-code-generation",
  "type": "llm",
  "data": {
    "label": "代码生成",
    "model": "deepseek-chat",
    "temperature": 0.2,
    "max_tokens": 4000,
    "prompt": "你是一个专业的Android开发工程师。根据以下需求分析，生成完整的Android代码。\n\n需求分析：{{input}}\n\n请生成以下内容：\n1. Java/Kotlin代码（包含必要的注释）\n2. 布局XML文件\n3. 资源文件配置\n4. 依赖配置（build.gradle）\n5. 使用说明\n\n代码要求：\n- 遵循Android开发最佳实践\n- 使用现代Android架构（推荐MVVM）\n- 包含错误处理\n- 代码注释清晰\n- 支持Android API 24+\n\n请以Markdown格式输出，包含代码块。"
  }
}
```

#### 5. 架构设计节点 (llm-architecture)
```json
{
  "id": "llm-architecture",
  "type": "llm",
  "data": {
    "label": "架构设计",
    "model": "deepseek-chat",
    "temperature": 0.3,
    "max_tokens": 3000,
    "prompt": "你是一个Android架构师。根据需求分析，设计一个合理的Android应用架构。\n\n需求分析：{{input}}\n\n请提供：\n1. 架构模式选择（MVP/MVVM/MVI）及理由\n2. 模块划分方案\n3. 技术栈选型（框架、库、工具）\n4. 目录结构设计\n5. 数据流设计\n6. 依赖关系图\n7. 扩展性考虑\n\n请以Markdown格式输出，包含架构图和说明。"
  }
}
```

#### 6. 问题诊断节点 (llm-diagnosis)
```json
{
  "id": "llm-diagnosis",
  "type": "llm",
  "data": {
    "label": "问题诊断",
    "model": "deepseek-chat",
    "temperature": 0.2,
    "max_tokens": 3000,
    "prompt": "你是一个Android问题诊断专家。分析用户提供的错误信息，提供诊断和解决方案。\n\n错误信息：{{user_query}}\n\n请提供：\n1. 问题类型（崩溃/ANR/内存泄漏/网络错误等）\n2. 根本原因分析\n3. 解决方案（步骤清晰）\n4. 修复代码示例\n5. 预防措施\n6. 相关文档链接\n\n请以Markdown格式输出。"
  }
}
```

#### 7. 性能优化节点 (llm-optimization)
```json
{
  "id": "llm-optimization",
  "type": "llm",
  "data": {
    "label": "性能优化",
    "model": "deepseek-chat",
    "temperature": 0.3,
    "max_tokens": 3000,
    "prompt": "你是一个Android性能优化专家。根据用户描述的性能问题，提供优化方案。\n\n性能问题：{{user_query}}\n需求分析：{{input}}\n\n请提供：\n1. 性能瓶颈分析\n2. 优化方案（按优先级排序）\n3. 具体优化代码\n4. 优化前后对比\n5. 性能测试建议\n6. 监控指标\n\n请以Markdown格式输出。"
  }
}
```

#### 8. 结果整合节点 (transform-integration)
```json
{
  "id": "transform-integration",
  "type": "transform",
  "data": {
    "label": "结果整合",
    "mode": "merge",
    "mapping": {
      "requirement_analysis": "{{input}}",
      "solution": "{{code_generation|architecture|diagnosis|optimization}}",
      "timestamp": "{{$timestamp}}",
      "agent_type": "Android开发助手"
    }
  }
}
```

#### 9. 格式化输出节点 (llm-format)
```json
{
  "id": "llm-format",
  "type": "llm",
  "data": {
    "label": "格式化输出",
    "model": "deepseek-chat",
    "temperature": 0.1,
    "max_tokens": 4000,
    "prompt": "请将以下Android开发方案整理成专业的Markdown文档格式。\n\n方案内容：{{input}}\n\n文档结构：\n1. 需求分析摘要\n2. 解决方案\n3. 代码示例\n4. 实施步骤\n5. 注意事项\n6. 参考资料\n\n请确保格式清晰、代码高亮正确、结构完整。"
  }
}
```

#### 10. 结束节点 (end-1)
```json
{
  "id": "end-1",
  "type": "end",
  "data": {
    "label": "结束",
    "description": "返回最终结果"
  }
}
```

## 📝 使用示例

### 示例1：生成登录功能代码

**用户输入**：
```
帮我生成一个Android登录功能的代码，包括：
1. 登录Activity
2. 登录ViewModel
3. 网络请求（使用Retrofit）
4. 登录布局XML
```

**Agent处理流程**：
1. 需求理解 → 识别为"代码生成"需求
2. 代码生成节点 → 生成完整登录功能代码
3. 结果整合 → 整合需求分析和代码
4. 格式化输出 → 生成Markdown文档

**输出内容**：
- 需求分析摘要
- MainActivity.java（登录Activity）
- LoginViewModel.java
- ApiService.java（Retrofit接口）
- activity_login.xml（布局文件）
- 使用说明

### 示例2：架构设计咨询

**用户输入**：
```
我想开发一个电商类Android应用，包含商品浏览、购物车、订单管理等功能。
请帮我设计应用架构。
```

**Agent处理流程**：
1. 需求理解 → 分析电商应用需求
2. 需求分类 → 识别为"架构设计"需求
3. 架构设计节点 → 生成架构方案
4. 结果整合 → 整合需求分析和架构设计
5. 格式化输出 → 生成架构设计文档

**输出内容**：
- 需求分析（应用类型、核心模块、复杂度）
- 架构模式选择（推荐MVVM）
- 模块划分（商品模块、购物车模块、订单模块等）
- 技术栈选型（Retrofit、Room、Glide等）
- 目录结构
- 数据流设计图

### 示例3：问题诊断

**用户输入**：
```
我的应用在启动时崩溃了，错误信息：
java.lang.RuntimeException: Unable to start activity ComponentInfo{...}: 
android.view.InflateException: Binary XML file line #15: Error inflating class android.support.v7.widget.Toolbar
```

**Agent处理流程**：
1. 需求理解 → 识别为"问题诊断"需求
2. 问题诊断节点 → 分析崩溃原因
3. 结果整合 → 整合诊断结果
4. 格式化输出 → 生成问题诊断报告

**输出内容**：
- 问题类型：XML布局解析错误
- 根本原因：Toolbar类导入错误或主题配置问题
- 解决方案：
  1. 检查依赖配置
  2. 修改Toolbar导入
  3. 检查主题配置
- 修复代码示例
- 预防措施

### 示例4：性能优化

**用户输入**：
```
我的应用列表页面滚动时很卡顿，特别是加载图片时。
请帮我优化性能。
```

**Agent处理流程**：
1. 需求理解 → 识别为"性能优化"需求
2. 性能优化节点 → 分析性能瓶颈
3. 结果整合 → 整合优化方案
4. 格式化输出 → 生成优化指南

**输出内容**：
- 性能瓶颈分析（图片加载、列表渲染）
- 优化方案：
  1. 使用Glide/Picasso进行图片加载和缓存
  2. RecyclerView优化（ViewHolder复用、分页加载）
  3. 异步加载图片
- 优化代码示例
- 性能测试建议

## 🛠️ 技术实现要点

### 1. Prompt设计原则
- **明确角色定位**：始终强调Agent是"专业的Android开发顾问/工程师"
- **结构化输出**：要求以JSON或Markdown格式输出
- **上下文传递**：确保前一个节点的输出能正确传递给下一个节点
- **错误处理**：在Prompt中包含错误处理要求

### 2. 条件判断逻辑
- 使用关键词匹配识别需求类型
- 支持多种需求类型的组合
- 提供默认分支处理未知需求

### 3. 代码生成质量
- 要求遵循Android开发最佳实践
- 包含必要的注释和文档
- 支持现代Android架构（MVVM推荐）
- 考虑兼容性（API 24+）

### 4. 输出格式统一
- 使用Markdown格式
- 代码块使用正确的语言标识（java、kotlin、xml等）
- 包含目录结构
- 提供使用说明

## 📊 测试用例

### 测试用例1：简单代码生成
```
输入：生成一个显示"Hello World"的Activity
预期：生成MainActivity.java和activity_main.xml
```

### 测试用例2：复杂架构设计
```
输入：设计一个支持多用户的社交类应用架构
预期：包含用户模块、社交模块、消息模块等的架构设计
```

### 测试用例3：问题诊断
```
输入：应用在Android 12上崩溃，错误是权限被拒绝
预期：提供Android 12权限变更说明和解决方案
```

### 测试用例4：性能优化
```
输入：应用启动时间超过5秒，如何优化？
预期：提供启动优化方案（懒加载、异步初始化等）
```

## 🚀 部署与使用

### 1. 创建Agent
1. 登录Agent管理平台
2. 点击"创建Agent"
3. 输入Agent名称："Android应用开发助手"
4. 描述："帮助开发者快速生成、优化和调试Android应用"

### 2. 配置工作流
1. 在工作流设计器中添加上述所有节点
2. 按照工作流结构连接节点
3. 配置每个节点的参数（参考节点配置部分）
4. 验证工作流逻辑

### 3. 测试Agent
1. 保存工作流
2. 部署Agent（状态改为"已发布"）
3. 使用测试工具或前端界面测试
4. 根据测试结果调整Prompt和节点配置

### 4. 优化建议
- **Prompt优化**：根据实际输出结果调整Prompt，使其更精确
- **温度参数**：代码生成使用较低温度（0.2），创意设计使用较高温度（0.7）
- **Token限制**：根据输出长度需求调整max_tokens
- **分支优化**：根据常见需求类型优化条件判断逻辑

## 📚 扩展功能建议

### 1. 代码审查功能
- 添加代码审查节点
- 分析代码质量、安全性、性能
- 提供改进建议

### 2. 测试用例生成
- 根据功能代码自动生成单元测试
- 生成UI测试用例
- 提供测试覆盖率建议

### 3. 依赖管理
- 分析项目依赖
- 检测过时依赖
- 推荐替代方案
- 生成依赖更新计划

### 4. 多语言支持
- 支持Kotlin代码生成
- 支持Flutter、React Native等跨平台框架建议

### 5. 版本适配
- 提供Android版本兼容性建议
- 检测API废弃警告
- 提供迁移方案

## ⚠️ 注意事项

1. **代码安全性**：生成的代码需要人工审查，特别是涉及用户数据和安全的部分
2. **最佳实践**：Agent提供的建议应该结合项目实际情况，不能盲目采用
3. **版本兼容性**：确保生成的代码支持目标Android版本
4. **性能考虑**：代码生成时应该考虑性能影响
5. **法律合规**：确保生成的代码符合相关法律法规要求

## 🔗 相关资源

- [Android开发官方文档](https://developer.android.com/)
- [Android架构指南](https://developer.android.com/topic/architecture)
- [Material Design指南](https://material.io/design)
- [Android性能优化](https://developer.android.com/topic/performance)

---

**最后更新**：2026-01-20

**版本**：v1.0

**作者**：Android开发智能体团队
