SoloPi Android Testing
Runs Android device tests and writes acceptance reports with full screenshots.
Install
npx skills add alipay/SoloPi --skill solopi-ai -g -a claude-code -y- Repository
- alipay/SoloPi6.4k
- Category
- Testing
- Updated
- 12d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- Yes, review before use
What it does
通过 SoloPi Harness 运行 Android 真机测试、选择支付宝内置模板并生成带完整截图的验收报告。默认使用规则，Laya 为可选的电脑本地实验模式。也支持从需求/AC 编译验证计划、交互录制、回放、动态 Agent、性能监控、签名端侧模型和多设备 CI。
SoloPi AI 控制框架
将本文件所在目录作为 Skill 根目录。只使用 Skill 的薄入口：
scripts/solopi-ai --pretty <命令>
执行时把 scripts/solopi-ai 解析为绝对路径，并保持调用者当前工作目录不变。Harness 实现与内置模板随本 Skill 放在 scripts/harness/，入口默认只调用这一份实现，不依赖仓库外的同级目录或已安装的 Python 包。调用方显式配置 SOLOPI_HARNESS_CLI 时可指定另一准确 CLI；普通使用无需配置。不得自行拼接 HTTP、Scheme 或 Shell 命令代替类型化 CLI。
安装时完整复制本 Skill 目录，保留脚本执行权限；运行需要 Python 3.9+ 和设备操作所需的 ADB。Laya 权重、虚拟环境、APK 和真机证据不随 Skill 打包。独立安装与本地验证见内置工作流。
全局参数必须放在子命令前。多台设备在线时，每次调用都必须添加 --serial <adb-serial>。
快速使用
用户要“连接手机跑几个案例”“运行支付宝模板”“查看带截图的结果”时，优先读取 内置工作流，使用以下入口：
scripts/solopi-ai --pretty workflow-list
scripts/solopi-ai --serial <adb-serial> --pretty workflow-run --template alipay-more-services
scripts/solopi-ai --pretty workflow-report --artifacts <上一步返回的artifacts>
默认规则模式不加载模型。只有用户明确选择 Laya 实验时，才传 --mode laya --model <本地MLX权重目录>；
模型运行在电脑上。不要为这些模板安装 companion APK，也不要把模型输出当成验收结论。
workflow-run 自动完成预检、计划编译与校验、执行及截图报告；前置页面不满足时保留 not_tested，
不自动重跑。完成后返回 Markdown 报告路径，并说明三态结果、清理结果和截图是否齐全。
能力路由
需要判断某项 App 能力是直接 CLI、用例间接、用户交互还是暂不可安全自动化时，先读取 能力矩阵。需要证明页面、设置和动作是否已纳入覆盖时，再读取 App 功能覆盖清单。
