.pouch/skills/android-tester/README.md

android-tester

在 Android 真机或 Debian Linux Android 模拟器上执行测试；每次先检查环境，最后生成可追溯的测试结果。

什么时候使用

• 「检查 Android 真机测试环境」
• 「检查 Debian Android 模拟器环境」
• 「用真机跑 Android smoke」
• 「用 AVD 跑 Android full」
• 「安装 Debian 上的 Android 模拟器」
• 「查看本次 Android 测试结果」

使用前准备

• 项目已有 .pouch/tester/ 和测试用例。
• 真机：开启 USB 调试并在设备上授权当前电脑。
• 模拟器：准备支持虚拟化的 Debian amd64 主机；首次使用可让 skill 安装 KVM、SDK Command-line Tools、Platform-Tools、Emulator 和指定系统镜像。
• 需要安装或启动应用时，提供 APK、包名和启动组件，或提供项目自己的测试命令。
• 安装模式会使用 sudo、apt 和用户组变更；运行前会先展示变更范围。

使用示例

检查 Android 真机环境，然后跑 smoke 测试

在 Debian 上安装 Android 模拟器，使用项目需要的 Android API 创建 AVD

用 Pixel_API_35 模拟器跑 Android full，失败时保留 logcat 和截图

Agent 会做什么

1. 明确选择真机或模拟器，不在两者之间自动切换。
2. 先检查 ADB、KVM、AVD、设备授权、启动状态和项目测试配置。
3. 模拟器路径可在 Debian amd64 上安装主机依赖和 Android SDK 模拟器组件。
4. 执行 .pouch/tester/ 中命中的 Android 用例。
5. 生成 YAML 运行快照、CSV 成绩单，失败时附带 logcat 和截图。

安装、安装 APK、清数据和修改设备设置都属于有副作用的操作，必须得到明确授权。

如何判断完成

• 环境检查有明确的通过项和阻塞项。
• 每条用例都有 pass、fail、environment-fail、skipped 或 not-run 结果。
• 运行记录位于 .pouch/tester/runs/，且 YAML 与 CSV 的 run id 一致。