diff --git a/README.md b/README.md index 96b5160..06b7b83 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@

- ARTEMIS Banner + ARTEMIS Banner

@@ -146,7 +146,19 @@ artemis mcp --generate-config all } ``` -### 3. Prompt Your Phone in the IDE Chat +### 3. Mount Behavioral Rules for AI Agents (Highly Recommended) + +To ensure your AI coding assistant acts with the rigor of a senior mobile test engineer and never hallucinates UI interactions, we provide a dedicated testing mindset rules file at [`mcp_server/rules.md`](./mcp_server/rules.md) (covering **Active Exploration before coding**, **Flash vs. Pro routing strategy**, **Latency & Timing compensation**, and the **"Dynamic-First, Coordinate-Fallback" locator pattern**). + +You can mount or copy [`mcp_server/rules.md`](./mcp_server/rules.md) into your AI IDE's rule configuration: +* **Antigravity**: Add the contents of `rules.md` to your Workspace Rules, Global Rules settings, or agent instructions. +* **Claude Code**: Copy or include the contents of `rules.md` in your project's `CLAUDE.md` file. +* **Cursor**: Copy the contents into `.cursorrules` or create a rule file at `.cursor/rules/artemis.mdc`. +* **Windsurf / OpenClaw**: Add the rules to your workspace rules or global system prompts. + +> 💡 For more details on the testing mindset and MCP architecture, see the [MCP Server README](./mcp_server/README.md). + +### 4. Prompt Your Phone in the IDE Chat In Antigravity or Claude Code, simply prompt: > 💬 *"Build the latest changes into an APK, install it on the connected device, open the login screen with a test account, verify if there are any unexpected popups after login, and return screenshots of the final page."* diff --git a/README_CN.md b/README_CN.md index 58df48f..9ecf866 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,5 +1,5 @@

- ARTEMIS Banner + ARTEMIS Banner

@@ -148,7 +148,19 @@ artemis mcp --generate-config all } ``` -### 3. 在 IDE 中体验真机协同 +### 3. 挂载智能体行为规范 Rules(强烈推荐) + +为使 AI 编程助手具备资深移动端测试工程师的严谨思维,避免凭空臆测 UI 交互,我们提供了专属的测试思维行为规范文件 [`mcp_server/rules.md`](./mcp_server/rules.md)(涵盖**可运行代码原则与真机探索**、**Flash 与 Pro 任务路由策略**、**延迟与时间补偿机制**以及**“动态优先、坐标兜底”定位模式**)。 + +你可以将 [`mcp_server/rules.md`](./mcp_server/rules.md) 挂载或复制到你的 AI IDE 规则配置中: +* **Antigravity**:将 `rules.md` 内容添加至工作区规则(Workspace Rules)或全局规则设置中。 +* **Claude Code**:将 `rules.md` 内容复制或引入至项目根目录的 `CLAUDE.md` 文件中。 +* **Cursor**:将内容复制到 `.cursorrules` 文件或在 `.cursor/rules/artemis.mdc` 中创建新规则。 +* **Windsurf / OpenClaw**:将内容添加到工作区规则或全局 System Prompt 中。 + +> 💡 更多规范设计细节与 MCP 架构说明,请参阅 [MCP Server 文档](./mcp_server/README.md)。 + +### 4. 在 IDE 中体验真机协同 在 Antigravity / Claude Code 对话框中直接输入: > 💬 *"请帮我把刚刚修改的代码编译成 APK 并安装到手机上,打开登录页面输入测试账号,验证登录后是否有异常弹窗,并把最终页面截图回传。"* diff --git a/docs/assets/artemis-banner-cn.png b/docs/assets/artemis-banner-cn.png index 0ce6ba0..8a9317e 100644 Binary files a/docs/assets/artemis-banner-cn.png and b/docs/assets/artemis-banner-cn.png differ diff --git a/docs/assets/artemis-banner-en.png b/docs/assets/artemis-banner-en.png index 39cbadc..31ffe71 100644 Binary files a/docs/assets/artemis-banner-en.png and b/docs/assets/artemis-banner-en.png differ diff --git a/docs/assets/artemis-banner.png b/docs/assets/artemis-banner.png index 39cbadc..4b03979 100644 Binary files a/docs/assets/artemis-banner.png and b/docs/assets/artemis-banner.png differ diff --git a/docs/assets/generate_banner.py b/docs/assets/generate_banner.py index 182347c..045266f 100644 --- a/docs/assets/generate_banner.py +++ b/docs/assets/generate_banner.py @@ -842,7 +842,7 @@ def create_banner_html(lang="en"): """ if lang == "cn": replacements = { - "__TAGLINE__": "用 自主 AI 测试任意安卓手机", + "__TAGLINE__": "用 Autonomous Assistant Platform 测试任意安卓手机", "__PROMPT_LABEL__": "目标 / 提示词", "__PROMPT_STATUS__": "设备实机运行中", "__PROMPT_TEXT__": "连接蓝牙耳机播放歌曲,并持续采集 CPU 性能指标", @@ -868,7 +868,7 @@ def create_banner_html(lang="en"): } else: replacements = { - "__TAGLINE__": "Test Any Android Phone with Autonomous AI", + "__TAGLINE__": "Test Any Android Phone with Autonomous Assistant Platform", "__PROMPT_LABEL__": "Goal / Prompt", "__PROMPT_STATUS__": "RUNNING ON DEVICE", "__PROMPT_TEXT__": "Connect to Bluetooth earbuds, play a song, and capture CPU usage metrics", diff --git a/mcp_server/README.md b/mcp_server/README.md index 7fb7951..f59ccd1 100644 --- a/mcp_server/README.md +++ b/mcp_server/README.md @@ -1,6 +1,6 @@ # 🔌 Universal MCP Server for ARTEMIS -This directory contains the universal **Model Context Protocol (MCP)** server for **ARTEMIS**, enabling seamless mobile device automation inside AI IDEs and agents like **Cursor**, **Claude Code**, **OpenClaw**, **Windsurf**, and **Jetski**. +This directory contains the universal **Model Context Protocol (MCP)** server for **ARTEMIS**, enabling seamless mobile device automation inside AI IDEs and agents like **Antigravity**, **Cursor**, **Claude Code**, **OpenClaw**, and **Windsurf**. ## 🏗️ Architecture @@ -32,7 +32,7 @@ mcp_server/ ## 🧠 AI Agent Behavioral Rules (`rules.md`) -When connecting ARTEMIS to AI coding assistants like **Claude Code**, **Cursor**, or **Windsurf**, providing the assistant with domain-specific testing discipline is critical for generating reliable test code. +When connecting ARTEMIS to AI coding assistants like **Antigravity**, **Claude Code**, **Cursor**, or **Windsurf**, providing the assistant with domain-specific testing discipline is critical for generating reliable test code. The included [`rules.md`](./rules.md) file contains the **Mobile Testing Mindset (ARTEMIS Integration)** guideline. It teaches the AI agent how to properly collaborate with ARTEMIS: @@ -42,6 +42,7 @@ The included [`rules.md`](./rules.md) file contains the **Mobile Testing Mindset 4. **"Dynamic-First, Coordinate-Fallback" Locator Pattern**: Teaches the AI to prioritize dynamic UI locators (Resource IDs, OCR text, semantics) for layout resilience, while implementing absolute coordinate fallbacks for maximum execution reliability. ### How to Apply `rules.md` in Your IDE +* **Antigravity**: Add or copy the contents of `rules.md` into your Workspace Rules, Global Rules settings, or agent instructions. * **Claude Code**: Copy or include the contents of `rules.md` in your project's `CLAUDE.md` file (or reference it directly in your instructions). * **Cursor**: Copy the contents of `rules.md` into your `.cursorrules` or create a new rule file in `.cursor/rules/artemis.mdc`. * **Windsurf / OpenClaw**: Add the rules to your global/workspace rules or agent system prompts so the assistant always follows verified mobile testing principles.