菜单
Use when running PoLang automated tests via JSON commands sent through AgentTestBroadcastReceiver, including test suites, single test cases, camera/agent feature verification, or performance/log collection
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agent-test |
| description | Use when running PoLang automated tests via JSON commands sent through AgentTestBroadcastReceiver, including test suites, single test cases, camera/agent feature verification, or performance/log collection |
定位：PC 端主导的 JSON 数据驱动自动化测试执行与诊断。 触发时机：用户提及运行测试、验证功能、发送测试命令、Accessibility UI 状态检查、性能采集时启用。
scripts/agent-tester suite camerascripts/agent-tester cmd '{"method":"flip_camera"}'scripts/agent-tester case scripts/tests/camera/xxx.json{"method":"...","params":{...}} 传给应用端-n 指定组件：com.mamba.picme/.testing.agent.bridge.AgentTestBroadcastReceiver{} 解释为 brace expansion# 导航到相机页
scripts/agent-tester cmd '{"method":"navigate_to","params":{"destination":"camera"}}'
# 切换画幅比例
scripts/agent-tester cmd '{"method":"switch_ratio","params":{"ratio":"16_9"}}'
# 切换滤镜
scripts/agent-tester cmd '{"method":"switch_filter","params":{"filter":"leica_classic"}}'
# 拍照
scripts/agent-tester cmd '{"method":"capture","params":{}}'
# 翻转摄像头
scripts/agent-tester cmd '{"method":"flip_camera","params":{}}'
# 相机套件
scripts/agent-tester suite camera
# 设置页套件
scripts/agent-tester suite settings
scripts/agent-tester case scripts/tests/camera/tc-camera-02-flip.json
adb devices | grep "device$"
# 应用是否运行
adb shell pidof com.mamba.picme
# 启动应用
adb shell am start -n com.mamba.picme/.MainActivity
# 清除日志
adb logcat -c
# 发送命令（示例：导航到相机页）
scripts/agent-tester cmd '{"method":"navigate_to","params":{"destination":"camera"}}'
# 查看 PoLang 相关日志
adb logcat -d | grep -iE "AgentTestReceiver|NavigationCapability|CapabilityRegistry|CameraCapability|scene"
首选：Accessibility UI dump（结构化文本，更准更省 token）
python3 scripts/ui_driver.py dump > /tmp/ui_dump.json
python3 scripts/ui_driver.py find --content-description "快门"
次选：截屏（仅用于最终视觉验证）
adb shell screencap -p /sdcard/test.png
adb pull /sdcard/test.png /tmp/test.png
| 陷阱 | 症状 | 修复 |
|---|---|---|
| 隐式广播被拦截 | 广播发送成功但无响应 | 使用 -n 显式组件 |
| JSON 被 brace expansion 截断 | json=method:switch_ratio | 用单引号包裹 JSON：--es json '{...}' |
| 场景不匹配命令排队 | 命令执行但 UI 无变化 | 先发送 navigate_to 切换到目标页面 |
| Capability delegate 未绑定 | CAPABILITY_UNAVAILABLE 错误 | 确保目标页面已显示并绑定 delegate |
| 日志过滤不到 | grep 无输出 | 检查 PID 是否正确，或直接用 adb logcat -d 全量查看 |
{"method":"<命令名>","params":{"<参数名>":"<值>"}}
| 命令 | 参数示例 | 说明 |
|---|---|---|
navigate_to | {"destination":"camera"} | 导航到指定页面 |
capture | - | 拍照 |
flip_camera | - | 切换前后摄像头 |
toggle_recording | - | 开始/停止录像 |
switch_ratio | {"ratio":"16_9"} | 切换画幅比例 |
switch_filter | {"filter":"leica_classic"} | 切换滤镜 |
switch_style | {"style":"toon"} | 切换风格 |
adjust_beauty | {"smoothing":80,"whitening":60} | 调整美颜 |
adjust_exposure | {"exposure":2} | 调整曝光 |
adjust_zoom | {"zoom":2.0} | 调整变焦 |
switch_mode | {"mode":"video"} | 切换拍摄模式 |
| 版本 | 日期 | 变更 |
|---|---|---|
| 2.1.0 | 2026-07-02 | 重命名目录和 skill 名从 agent-test-expert 到 agent-test |
| 2.0.0 | 2026-07-02 | 统一标题为 Agent Test；UI 验证优先使用 accessibility dump |
| 1.0.0 | 2026-06-06 | 初始版本，基于 Agent Test V2 JSON 驱动架构 |
Use when connecting Android devices, controlling app lifecycle, filtering logs, taking screenshots, pulling files, or checking performance metrics via adb
Use when running the full PoLang development self-heal loop from code check through install, device verification, and report generation
Use when performing PoLang QA acceptance, including end-to-end verification, boundary testing, performance baseline comparison, and red-line compliance checks
Use when automating PoLang UI interactions through structured accessibility data, replacing screenshot-based image recognition with precise text, contentDescription, or bounds-driven actions