Dogfood 移动应用自动化测试工具 - 系统探索与问题报告生成

dogfood by callstackincubator/agent-device

259 周安装量

1,200 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/callstackincubator/agent-device --skill dogfood

自动化移动应用测试

🇨🇳中文介绍

Dogfood (agent-device)

系统性地探索移动应用，发现问题，并为每个发现生成包含完整复现证据的报告。

设置

仅 目标应用 是必需的。其他所有内容都有合理的默认值。

参数	默认值	示例覆盖
目标应用	(必填)	`Settings`、`com.example.app`、深度链接 URL
平台	从用户上下文推断；否则询问 (`ios` 或 `android`)	`--platform ios`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

104,600 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

27,800 周安装

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

27,600 周安装

如果用户提供了足够的上下文来开始，则立即使用默认值开始。仅当缺少必需细节（例如平台或凭据）时，才询问后续问题。

优先使用直接的 agent-device 二进制文件（如果可用）。

1. 初始化    设置会话、输出目录、报告文件
2. 启动/认证  打开应用并在需要时登录
3. 定位        捕获初始快照并映射导航
4. 探索        系统性地测试流程和状态
5. 记录        为每个问题记录可复现的证据
6. 收尾        汇总摘要，关闭会话

mkdir -p {OUTPUT_DIR}/screenshots {OUTPUT_DIR}/videos
cp {SKILL_DIR}/templates/dogfood-report-template.md {OUTPUT_DIR}/report.md

启动一个命名会话并打开目标应用：

agent-device --session {SESSION} open {TARGET_APP} --platform {PLATFORM}
agent-device --session {SESSION} snapshot -i

如果需要登录：

agent-device --session {SESSION} snapshot -i
agent-device --session {SESSION} fill @e1 "{EMAIL}"
agent-device --session {SESSION} fill @e2 "{PASSWORD}"
agent-device --session {SESSION} press @e3
agent-device --session {SESSION} wait 1000
agent-device --session {SESSION} snapshot -i

对于 OTP/邮件验证码：询问用户，等待输入，然后继续。

捕获初始证据和导航锚点：

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/initial.png
agent-device --session {SESSION} snapshot -i

在进行深度测试之前，映射顶层导航、标签页和关键工作流程。

阅读 references/issue-taxonomy.md 以进行严重性/类别校准。

遍历每个主要的应用区域（标签页、抽屉、设置页面）。
端到端测试核心流程（创建、编辑、删除、提交、恢复）。
验证边缘状态（空/错误/加载/离线/权限被拒）。
在 UI 转换后使用 diff snapshot -i 以避免过时的引用。
定期捕获 logs path 并在行为看起来可疑时检查应用日志。

每个屏幕的有用命令：

agent-device --session {SESSION} snapshot -i
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/{screen-name}.png
agent-device --session {SESSION} appstate
agent-device --session {SESSION} logs path

5. 记录问题（优先复现）

一次性完成探索和记录。当发现问题时，停止并完全捕获证据，然后再继续。

交互式/行为问题

使用视频 + 步骤截图：

agent-device --session {SESSION} record start {OUTPUT_DIR}/videos/issue-{NNN}-repro.mp4

以可见的节奏复现。捕获每个步骤：

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-step-1.png

sleep 1
# 执行操作
sleep 1
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-step-2.png

3. 捕获最终的损坏状态：

sleep 2
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-result.png

agent-device --session {SESSION} record stop

5. 立即将问题附加到报告中，并附上编号步骤和截图引用。

静态/加载时问题

单张截图即可；不需要视频：

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}.png

在报告中将 复现视频 设置为 N/A。

目标是 5-10 个有充分证据的问题，然后完成：

在 report.md 中核对摘要严重性计数。
关闭会话：

agent-device --session {SESSION} close

报告问题总数、严重性细分和最高风险发现。

复现质量比问题数量更重要。
使用引用 (@eN) 进行快速探索，在需要确定性重放断言时使用选择器。
在任何变更（导航、模态框、列表更新、表单提交）后重新快照。
使用 fill 实现清空后输入的语义；使用 type 检查增量输入行为。
保持日志可选且有针对性：仅在有助于诊断时启用/读取应用日志。
切勿读取被测应用的源代码；发现必须来自观察到的运行时行为。
立即记录每个问题，以免丢失证据。
在会话期间切勿删除截图/视频/报告工件。

参考	何时阅读
references/issue-taxonomy.md	会话开始时；严重性/类别/检查清单

模板	用途
templates/dogfood-report-template.md	复制到输出目录作为报告文件

🇺🇸English

Dogfood (agent-device)

Systematically explore a mobile app, find issues, and produce a report with full reproduction evidence for every finding.

Setup

Only the Target app is required. Everything else has sensible defaults.

Parameter	Default	Example override
Target app	(required)	`Settings`, `com.example.app`, deep link URL
Platform	Infer from user context; otherwise ask (`ios` or `android`)	`--platform ios`
Session name	Slugified app/platform (for example `settings-ios`)	`--session my-session`
Output directory	`./dogfood-output/`	`Output directory: /tmp/mobile-qa`
Scope	Full app	`Focus on onboarding and profile`
Authentication	None	`Sign in to user@example.com`

If the user gives enough context to start, begin immediately with defaults. Ask follow-up only when a required detail is missing (for example platform or credentials).

Prefer direct agent-device binary when available.

Workflow

1. Initialize    Set up session, output dirs, report file
2. Launch/Auth   Open app and sign in if needed
3. Orient        Capture initial snapshot and map navigation
4. Explore       Systematically test flows and states
5. Document      Record reproducible evidence per issue
6. Wrap up       Reconcile summary, close session

1. Initialize

mkdir -p {OUTPUT_DIR}/screenshots {OUTPUT_DIR}/videos
cp {SKILL_DIR}/templates/dogfood-report-template.md {OUTPUT_DIR}/report.md

2. Launch/Auth

Start a named session and launch target app:

agent-device --session {SESSION} open {TARGET_APP} --platform {PLATFORM}
agent-device --session {SESSION} snapshot -i

If login is required:

agent-device --session {SESSION} snapshot -i
agent-device --session {SESSION} fill @e1 "{EMAIL}"
agent-device --session {SESSION} fill @e2 "{PASSWORD}"
agent-device --session {SESSION} press @e3
agent-device --session {SESSION} wait 1000
agent-device --session {SESSION} snapshot -i

For OTP/email codes: ask the user, wait for input, then continue.

3. Orient

Capture initial evidence and navigation anchors:

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/initial.png
agent-device --session {SESSION} snapshot -i

Map top-level navigation, tabs, and key workflows before deep testing.

4. Explore

Read references/issue-taxonomy.md for severity/category calibration.

Strategy:

Move through each major app area (tabs, drawers, settings pages).
Test core journeys end-to-end (create, edit, delete, submit, recover).
Validate edge states (empty/error/loading/offline/permissions denied).
Use diff snapshot -i after UI transitions to avoid stale refs.
Periodically capture logs path and inspect the app log when behavior looks suspicious.

Useful commands per screen:

agent-device --session {SESSION} snapshot -i
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/{screen-name}.png
agent-device --session {SESSION} appstate
agent-device --session {SESSION} logs path

5. Document Issues (Repro-First)

Explore and document in one pass. When you find an issue, stop and fully capture evidence before continuing.

Interactive/behavioral issues

Use video + step screenshots:

Start recording:

agent-device --session {SESSION} record start {OUTPUT_DIR}/videos/issue-{NNN}-repro.mp4

Reproduce with visible pacing. Capture each step:

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-step-1.png

sleep 1
# perform action
sleep 1
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-step-2.png

3. Capture final broken state:

sleep 2
agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}-result.png

4. Stop recording:

agent-device --session {SESSION} record stop

5. Append issue immediately to report with numbered steps and screenshot references.

Static/on-load issues

Single screenshot is sufficient; no video required:

agent-device --session {SESSION} screenshot {OUTPUT_DIR}/screenshots/issue-{NNN}.png

Set Repro Video to N/A in the report.

6. Wrap Up

Target 5-10 well-evidenced issues, then finish:

Reconcile summary severity counts in report.md.
Close session:

agent-device --session {SESSION} close

Report total issues, severity breakdown, and highest-risk findings.

Guidance

Repro quality matters more than issue count.
Use refs (@eN) for fast exploration, selectors for deterministic replay assertions when needed.
Re-snapshot after any mutation (navigation, modal, list update, form submit).
Use fill for clear-then-type semantics; use type for incremental typing behavior checks.
Keep logs optional and targeted: enable/read app logs only when useful for diagnosis.
Never read source code of the app under test; findings must come from observed runtime behavior.
Write each issue immediately to avoid losing evidence.
Never delete screenshots/videos/report artifacts during a session.

References

Reference	When to Read
references/issue-taxonomy.md	Start of session; severity/categories/checklist

Templates

Template	Purpose
templates/dogfood-report-template.md	Copy into output directory as the report file

Weekly Installs

Repository

callstackincuba…t-device

GitHub Stars

995

First Seen

8 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

claude-code74

opencode72

github-copilot72

amp72

cline72

codex72

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

27,400 周安装

Dogfood 移动应用自动化测试工具 - 系统探索与问题报告生成

🇨🇳中文介绍

Dogfood (agent-device)

设置

相关 Skills

工作流程

1. 初始化

2. 启动/认证

3. 定位

4. 探索

5. 记录问题（优先复现）

交互式/行为问题

静态/加载时问题

6. 收尾

指导原则

参考

模板

🇺🇸English

Dogfood (agent-device)

Setup

Workflow

1. Initialize

2. Launch/Auth

3. Orient

4. Explore

5. Document Issues (Repro-First)

Interactive/behavioral issues

Static/on-load issues

6. Wrap Up

Guidance

References

Templates

最新 Skills