Artemis-Eapil/skills/artemis-use/SKILL.md

name, description

name	description
artemis-use	使用 ARTEMIS 执行安卓、电脑和跨端测试，指导探索用例，排查或复盘任务，以及开发符合 ARTEMIS 规范的扩展插件。用户提到 ARTEMIS 任务编号、测试报告、缓存消耗或插件适配时使用。

ARTEMIS 使用与插件开发

ARTEMIS 自己编排手机和已授权插件，共用网页的任务队列、历史与报告。主程序由用户启动；Codex 的 MCP 仅连接，不另起后台或独立执行器。主程序离线时告知用户先启动 ARTEMIS，不能反复重提任务。

按任务选择参考

用户要做什么	阅读什么
选择模式、执行或指导单任务	执行模式与操作流程
边交流边探索、亲自示范、提炼复用用例	探索流程与 MCP 参数
批量、循环压测、选择导入项、交付资料	批次与报告
给出任务编号，问失败原因、token、缓存、录像或最终结论	诊断与复盘
使用电脑、路由器、终端等已安装能力	插件任务参数
编写、适配、验证或发布 ARTEMIS 插件	插件开发规范，按需读取 清单与市场协议
插件调用外部程序、消费已批准文件或准备市场材料	运行辅助接口、故障自测与市场检查
开发回放侧栏、人工表单或扩展报告字段	工作区插件接口（ARTEMIS 2.3.0+）

只读当前任务相关参考。普通执行不加载插件开发文档。

三种模式

• Flash：路径明确的快速执行，单个执行模型观察并操作；适合冒烟、稳定流程与探索后复跑。可以接受中途指导；最终 AI 判定与分析默认关闭，可在全局功能配置开启。关闭时显示“未做 AI 判定”，不能当作验收通过。任务长不自动等于需要 Pro。
• Pro：需要持久计划、多个分支、检查点、ADB/日志诊断或详细报告；按计划执行并验证。explorer_mode 是 Pro 的视觉定位深度，不是探索任务模式。
• 探索：用户只有大概流程，需要与模型交流、纠正方向或人工示范；以 Pro 的执行能力推进，最终提炼一个可复用用例。超时保存并暂停，可继续。探索成功、生成用例和 Flash/Pro 复跑成功是三个不同结果。

Android 任务内可按助手能力使用 read_control、control_action、wait_until、scroll_to、pinch 与 touch_gesture，Flash/普通 Pro/探索共用。原生 selector 原样复制观察值，UTF-16 选区不能切开 emoji 代理对；手势完成不代表 APP 收到，确认键盘/遮挡、实际控件值和停稳状态。工具参数、序列组合与时间轴精度边界见 原生动作说明。

以上是 ARTEMIS 执行模式，不是 API 模型名。每种模式的适用场景、能力差异、参数及跟踪方式见 modes.md。沿用用户选定模式和模型；信息足够时直接执行，不反复要求批准。

共用规则

1. mobile_workspace 发现当前设备、队列、实际插件。沿用用户指定设备；多台设备而目标不明时先问。纯电脑任务用 include_devices=false，无需手机；普通安卓任务可按需使用已授权扩展。
2. 明确任务目标、前置条件和通过标准；用户没有要求时不擅自清数据、重装或重置环境。不假设启动时画面与旧任务相同。
3. 提交前保存唯一 request_id。同一次提交网络异常时保留原 ID 和内容，先反查，不用新 ID 自动重跑。模型请求重试不等于业务用例重跑。
4. 用 MCP 返回的任务编号跟踪；查看实际动作与证据，不把“已接收指导”当作“已经执行”。同一设备或桌面资源串行，其他资源可并行。
5. completed 只表示执行结束。读取 test_result.status/reason/source：passed、failed、inconclusive、blocked。人工复验优先，同时保留 AI 原判；Agent 自己的判断不能标成人工。
6. 失败或停滞先看当前任务诊断，再决定是否检查环境；不要靠连续重提测试排错。证据不足明确说明未验证，工具成功不能代替业务验收。
7. 用户明确要求删除时先查看 deletion_preview 的实际影响，再执行。已有明确授权不重复询问。人工复验只代录用户明确给出的通过/不通过及理由。
8. 密钥在网页或环境中配置，MCP 不接收；不读出或回显凭据。mobile_config 修改默认配置需要用户明确要求，临时任务用单任务配置。
9. 通过 mobile_export_report 交付真实路径或下载链接。手机和电脑证据按来源区分，未录到的画面不能推断。插件写操作结果不确定时先观察，不自动重复。

安装与版本

本目录是 ARTEMIS 管理的官方 artemis-use，服务启动时按内容检查并覆盖更新，不在这里定制个人规则。显式修复安装用 artemis mcp --install codex（源码环境前加 uv run）。Skill 与参考、模板一并更新；MCP 握手不安装、不启动主程序。

以当前连接服务和实际工具参数为准；旧版缺少动作时明确说明版本限制，不能假装执行成功或直接改数据库。升级 ARTEMIS 使用 update.bat / update-cn.bat，会停止该项目任务，只在用户要求升级时执行。