القائمة
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 ويثبّتها لك.
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
استنادا إلى تصنيف 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 驱动架构 |