Android 多 Agent 协作系统 - 快速上手指南

一、已创建的 Agent 角色

本系统已创建 10 个专业 Agent，覆盖 Android 开发的各个领域：

二、使用方式

方式 1：直接调用技能（推荐）

/skill <角色名>
<你的需求>

示例：

/skill android-architect
帮我设计一个多网融合消息系统的架构，支持 4G、北斗、自组网三种通信方式

方式 2：通过协调者分配任务

/skill android-team-coordinator
任务：实现北斗短报文发送功能

请协调以下 Agent 完成：
1. architect - 设计技术方案
2. protocol - 实现北斗协议
3. bluetooth - 蓝牙连接北斗盒子
4. ui - 发送界面
5. reviewer - 代码审查
6. test - 编写测试

方式 3：隐式调用

在对话中直接提及角色名称：

请以网络协议工程师的视角，分析这段 JT808 协议代码的编解码逻辑...

三、典型使用场景

场景 1：新功能开发

需求：实现北斗短报文发送功能

/skill android-team-coordinator

任务：北斗短报文发送功能

请分解任务并协调相关 Agent 完成：
- 架构设计
- 协议实现
- 蓝牙通信
- UI 界面
- 代码审查
- 单元测试
- 技术文档

场景 2：代码审查

需求：审查新编写的消息队列代码

/skill code-reviewer

请审查以下代码：
文件：app/src/main/java/.../MessageQueue.kt

审查重点：
1. 内存泄漏风险
2. 协程使用是否合理
3. 线程安全问题

场景 3：问题排查

需求：蓝牙连接频繁断开

/skill debug-specialist

问题：蓝牙连接北斗盒子时，频繁断开

现象：
1. 连接成功后约 10 秒断开
2. 日志显示 "Connection reset by peer"
3. 不同设备表现不一致

请分析可能原因并给出解决方案

场景 4：技术方案设计

需求：设计多网融合通信架构

/skill android-architect

需求背景：
- 需要融合 4G/5G、北斗短报文、自组网三种通信方式
- 消息类型：SOS、图片、语音、文本
- 要求高可靠性，支持断点续传

请输出技术方案，包括：
1. 整体架构设计
2. 核心类设计
3. 消息队列方案
4. 网络切换策略

场景 5：单元测试编写

需求：为 Repository 编写单元测试

/skill test-engineer

请为 MessageRepository 编写单元测试，覆盖以下场景：
1. 发送消息成功
2. 发送消息失败（网络异常）
3. 接收消息流
4. 消息存储到数据库

使用 JUnit + Mockk 框架

四、Agent 协作流程图

                     用户需求
                        │
                        ▼
              ┌─────────────────┐
              │  android-team-  │
              │   coordinator   │
              └─────────────────┘
                        │
          ┌─────────────┼─────────────┐
          │             │             │
          ▼             ▼             ▼
   ┌───────────┐ ┌───────────┐ ┌───────────┐
   │ architect │ │  coder    │ │ protocol  │
   └───────────┘ └───────────┘ └───────────┘
          │             │             │
          └─────────────┼─────────────┘
                        │
                        ▼
              ┌─────────────────┐
              │  code-reviewer  │
              └─────────────────┘
                        │
          ┌─────────────┼─────────────┐
          │             │             │
          ▼             ▼             ▼
   ┌───────────┐ ┌───────────┐ ┌───────────┐
   │   test    │ │  debug    │ │   doc     │
   └───────────┘ └───────────┘ └───────────┘

五、Skill 文件位置

所有 Skill 文件位于：

D:\dazhao\learning\documents\ClaudeCode\.claude\skills\

文件列表：

├── android-team-coordinator.skill.md
├── android-architect.skill.md
├── kotlin-coder.skill.md
├── network-protocol-engineer.skill.md
├── bluetooth-hardware-dev.skill.md
├── ui-component-dev.skill.md
├── code-reviewer.skill.md
├── test-engineer.skill.md
├── debug-specialist.skill.md
└── doc-writer.skill.md

六、自定义 Skill

如需修改某个 Agent 的技能定义，直接编辑对应的 .skill.md 文件。

Skill 文件结构：

---
name: <skill-name>
description: <简短描述>
tools: [Read, Edit, Write, Bash, ...]
---

# <角色名称>

## 角色定位
...

## 核心技能
...

## 工作流程
...

## 输出规范
...

## 与其他 Agent 协作
...

七、最佳实践

✅ 推荐做法

1. 复杂任务使用协调者 - 自动分解和分配任务
2. 专业问题调用专家 - 如协议问题找 network-protocol-engineer
3. 代码完成后审查 - 必ず调用 code-reviewer
4. 重要方案写文档 - 调用 doc-writer 输出文档

❌ 避免做法

1. 不要一个 Agent 做所有事 - 失去专业化优势
2. 不要跳过代码审查 - 增加 bug 风险
3. 不要忘记写文档 - 知识无法沉淀

八、常见问题

Q: 如何查看某个 Agent 的完整技能定义？

A: 读取对应的 .skill.md 文件：

Read D:\dazhao\learning\documents\ClaudeCode\.claude\skills\android-architect.skill.md

Q: 可以同时调用多个 Agent 吗？

A: 可以，协调者会自动安排顺序，或者手动依次调用。

Q: 如何保存 Agent 的输出结果？

A: 重要的输出保存到项目文档目录，如 pan/设计文档/。

九、参考文档

• 详细设计文档：009-Android 开发多 Agent 协作系统设计指南.md
• 各 Agent 技能定义：.claude/skills/*.skill.md

祝你使用愉快！有任何问题随时询问。 🚀