@testin-official/xagent 0.3.7 → 0.3.8

package/dist/action/mcp-content.d.ts

@@ -1,2 +1,5 @@
-export declare function actionMcpContent(toolName: string, result: Record<string, any>): Promise<Array<Record<string, string>>>;
+type McpContent = Array<Record<string, string>>;
+export declare function actionMcpContent(toolName: string, result: Record<string, any>): Promise<McpContent>;
+export declare function workflowMcpContent(toolName: string, result: Record<string, any>): Promise<McpContent>;
+export {};
 //# sourceMappingURL=mcp-content.d.ts.map

package/dist/action/mcp-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-content.d.ts","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"AAkEA,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA8B5H"}
+{"version":3,"file":"mcp-content.d.ts","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"AAWA,KAAK,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AA8IhD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAEzG;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAE3G"}

package/dist/action/mcp-content.js

@@ -1,4 +1,6 @@
+import { createHash } from "node:crypto";
 import { XAgentApiError } from "../core/errors.js";
+import { persistObservationEvidence } from "../evidence/store.js";
 import sharp from "sharp";
 const MAX_IMAGE_BYTES = 15 * 1024 * 1024;
 const MAX_MCP_IMAGE_BYTES = 200 * 1024;
@@ -11,7 +13,7 @@ function textFor(toolName, result) {
     }
     return JSON.stringify(result);
 }
-function observationFor(toolName, result) {
+function actionObservationFor(toolName, result) {
     if (toolName === "xagent_device_acquire")
         return result.observation;
     if (toolName === "xagent_device_observe")
@@ -20,6 +22,53 @@ function observationFor(toolName, result) {
         return result.after_observation ?? undefined;
     return undefined;
 }
+function screenKey(value, fallback) {
+    const explicit = String(value ?? "").trim();
+    if (explicit)
+        return explicit;
+    return `screen_${createHash("sha256").update(fallback, "utf8").digest("hex").slice(0, 16)}`;
+}
+function evidenceCandidates(toolName, result) {
+    const actionObservation = actionObservationFor(toolName, result);
+    if (actionObservation)
+        return [{ observation: actionObservation, result }];
+    if (toolName === "xagent_authoring_observe")
+        return [{ observation: result, result }];
+    if (toolName === "xagent_authoring_draft_step_execute" || toolName === "xagent_authoring_attempt_get") {
+        const artifacts = Array.isArray(result.artifacts) ? result.artifacts : [];
+        return artifacts
+            .filter((artifact) => artifact?.type === "screenshot" && typeof artifact.url === "string")
+            .map((artifact, index) => ({
+            result,
+            observation: {
+                ...result,
+                screenshot_url: artifact.url,
+                screen_id: screenKey(undefined, `${result.id ?? "attempt"}:${result.step_index ?? index}:${artifact.url}`),
+            },
+        }));
+    }
+    if (toolName === "xagent_run_get" || toolName === "xagent_run_wait") {
+        const runId = String(result.id ?? result.run_id ?? "run").trim();
+        const candidates = [];
+        for (const execution of Array.isArray(result.device_executions) ? result.device_executions : []) {
+            for (const step of Array.isArray(execution?.steps) ? execution.steps : []) {
+                if (typeof step?.screenshot_url !== "string" || !step.screenshot_url.trim())
+                    continue;
+                candidates.push({
+                    result,
+                    observation: {
+                        ...step,
+                        session_id: `run:${runId}`,
+                        device_id: execution.device_id,
+                        screen_id: screenKey(undefined, `${runId}:${execution.id ?? execution.device_id}:${step.sequence}:${step.screenshot_url}`),
+                    },
+                });
+            }
+        }
+        return candidates;
+    }
+    return [];
+}
 function assertImageUrl(value) {
     if (typeof value !== "string")
         throw new XAgentApiError("invalid_response", "Device observation has no screenshot URL");
@@ -38,9 +87,7 @@ function assertImageUrl(value) {
 async function prepareMcpImage(bytes, mimeType) {
     if (bytes.length <= MAX_MCP_IMAGE_BYTES)
         return { bytes, mimeType };
-    const pipeline = sharp(bytes, { failOn: "error", limitInputPixels: 100_000_000 })
-        .rotate()
-        .flatten({ background: "#ffffff" });
+    const pipeline = sharp(bytes, { failOn: "error", limitInputPixels: 100_000_000 }).rotate().flatten({ background: "#ffffff" });
     let smallest;
     for (const quality of JPEG_QUALITIES) {
         const candidate = await pipeline.clone().jpeg({ quality, mozjpeg: true }).toBuffer();
@@ -57,21 +104,13 @@ async function prepareMcpImage(bytes, mimeType) {
     while (candidate.length > MAX_MCP_IMAGE_BYTES && longestEdge > 640) {
         const ratio = Math.min(0.9, Math.sqrt(MAX_MCP_IMAGE_BYTES / candidate.length) * 0.95);
         longestEdge = Math.max(640, Math.floor(longestEdge * ratio));
-        candidate = await pipeline.clone()
-            .resize({ width: longestEdge, height: longestEdge, fit: "inside", withoutEnlargement: true })
-            .jpeg({ quality: 72, mozjpeg: true })
-            .toBuffer();
+        candidate = await pipeline.clone().resize({ width: longestEdge, height: longestEdge, fit: "inside", withoutEnlargement: true }).jpeg({ quality: 72, mozjpeg: true }).toBuffer();
     }
-    if (candidate.length > MAX_MCP_IMAGE_BYTES) {
+    if (candidate.length > MAX_MCP_IMAGE_BYTES)
         throw new XAgentApiError("invalid_response", "Device observation screenshot cannot be reduced to the MCP image limit");
-    }
     return { bytes: candidate, mimeType: "image/jpeg" };
 }
-export async function actionMcpContent(toolName, result) {
-    const content = [{ type: "text", text: textFor(toolName, result) }];
-    const observation = observationFor(toolName, result);
-    if (!observation)
-        return content;
+async function fetchImage(observation) {
     const url = assertImageUrl(observation.screenshot_url);
     let response;
     try {
@@ -109,8 +148,33 @@ export async function actionMcpContent(toolName, result) {
     }
     if (total === 0)
         throw new XAgentApiError("invalid_response", "Device observation screenshot is empty");
-    const image = await prepareMcpImage(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))), mimeType);
-    content.push({ type: "image", data: image.bytes.toString("base64"), mimeType: image.mimeType });
+    return prepareMcpImage(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))), mimeType);
+}
+async function contentWithEvidence(toolName, result, strict) {
+    const content = [{ type: "text", text: textFor(toolName, result) }];
+    for (const candidate of evidenceCandidates(toolName, result)) {
+        try {
+            const image = await fetchImage(candidate.observation);
+            try {
+                await persistObservationEvidence({ sourceTool: toolName, result: candidate.result, observation: candidate.observation, bytes: image.bytes, mimeType: image.mimeType });
+            }
+            catch (error) {
+                process.stderr.write(`${JSON.stringify({ xagent_evidence_cache: { status: "failed", cause: error instanceof Error ? error.message : String(error) } })}\n`);
+            }
+            content.push({ type: "image", data: image.bytes.toString("base64"), mimeType: image.mimeType });
+        }
+        catch (error) {
+            if (strict)
+                throw error;
+            process.stderr.write(`${JSON.stringify({ xagent_evidence_fetch: { status: "failed", tool: toolName, cause: error instanceof Error ? error.message : String(error) } })}\n`);
+        }
+    }
     return content;
 }
+export async function actionMcpContent(toolName, result) {
+    return contentWithEvidence(toolName, result, true);
+}
+export async function workflowMcpContent(toolName, result) {
+    return contentWithEvidence(toolName, result, false);
+}
 //# sourceMappingURL=mcp-content.js.map

package/dist/action/mcp-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-content.js","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-content.js","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"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"}

package/dist/assets/integrations/manifest.json

@@ -1,8 +1,9 @@
 {
   "schema_version": "xagent-skill/v1",
   "skill_name": "xagent-skill",
-  "skill_version": "0.3.5",
-  "minimum_cli_version": "0.3.5",
+  "skill_version": "0.3.8",
+  "minimum_cli_version": "0.3.8",
+  "evidence_schema_version": "xagent-evidence/v1",
   "default_domain": "action",
   "mcp_protocol": "stdio",
   "route_table_hash": "sha256:5aa8f83d0093cbcb93d661e60b1d516ef377402e41619cec2fae6ffb36eb6a5e",

package/dist/assets/integrations/xagent-skill/SKILL.md

@@ -1,28 +1,44 @@
 ---
 name: xagent-skill
-description: Use XAgent to inspect or control an Android device, author and verify a YAML test, run an existing test, analyze evidence, repair an explicitly selected test, or produce a report. Install this Skill once and let it route each request to exactly one XAgent CLI/MCP workflow.
+description: |
+  面向用户的 XAgent 测试与移动设备入口。用于查询或操作云真机、安装应用、验证目标、编写或执行测试、分析或修复失败，以及生成带截图证据的 Markdown 测试报告。
+  用户明确提到 XAgent、XAgent MCP、开发者设备、XAgent 测试或 XAgent 报告时触发。
 ---
 
-# XAgent
+# XAgent 用户入口
 
-This is the single Agent Host entry for XAgent. The CLI is the cross-platform execution client and `xagent-local` MCP is the stateful Tool adapter. They use the same public API contracts and route table; this Skill must not reimplement device or test business logic.
+用户只需要说明最终目标。入口负责准备环境、选择一个明确流程，并按用户要求串联后续结果；不要让用户理解 MCP mode、Session、screen_id、幂等键或本地证据缓存。
 
-## Before Any Operation
+## 准备
 
-1. Check that `xagent` is installed and that its version satisfies `manifest.json`.
-2. Check the configured Profile and MCP connection without printing a Token.
-3. Validate the Skill manifest and route-table hash against the CLI. If a check fails, stop before any upload, device, Authoring, Run, or report side effect.
-4. Present the available behavior choices. `action` is the default; never silently select another side-effect mode.
-5. Select exactly one domain and load only its matching packaged/server Skill.
+按 `references/setup-and-doctor.md` 检查 Profile、凭证、CLI、Skill 和 MCP 状态。正常时直接开始；只有缺少初始化、登录、同步或重启时才说明需要用户完成的动作。
 
-The choices are: `action` (direct device control), `author` (write and verify a test), `run` (execute existing YAML), `analyze` (read-only evidence analysis), `repair` (authorized test repair), and `report` (evidence report). `setup` is an entry check only and is not a user business mode.
+## 选择流程
 
-## Execution Boundary
+- 操作设备或验证手机界面：`xagent-explore-device`
+- 编写并逐步验证新测试：`xagent-author-test`
+- 执行用户指定的现有测试：`xagent-run-test`
+- 只读分析现有失败：`xagent-analyze-failure`
+- 用户明确授权后修复测试：`xagent-repair-test`
+- 从已经收集的证据生成报告：`xagent-test-report`
 
-- Prefer the connected MCP mode for Agent work. It keeps the device Session, current screen, renewal, and release state between Tool calls.
-- Use the CLI for terminal and CI workflows. Stateful CLI commands must carry the current `session_id`, latest `screen_id`, and a unique idempotency key.
-- Route with `xagent_workflow_options` and `xagent_workflow_route`, then verify `xagent_skill_load_local` (name, version, hash, and references) before side effects.
-- A routed mode may load only its mapped Skill. Changing mode requires the Host to start the corresponding isolated MCP process or restart `xagent-local`.
-- Never pass a Developer Token on a command line, put it in YAML, or copy it into a Skill. Personal credentials use the OS credential store; CI credentials use an explicitly named environment variable.
+意图明确时直接进入对应流程。只有不同理解会产生不同业务结果时才询问用户，不展示内部模式选择。
 
-Read the relevant file in `references/` only after the domain is selected. The Skill owns routing and safety gates; the routed Skill owns its workflow.
+## 用户可见执行
+
+设备相关流程展示关键截图和一句可见结果。失败时区分应用结果、设备控制、网络和证据问题。Action 或步骤状态 `PASSED` 只说明命令完成，业务结论必须由用户要求的可见后置条件支持。
+
+用户一次要求多个结果时，入口只编排必要阶段，例如：
+
+```text
+测试验证 → 保存证据 → 释放资源 → 生成报告
+```
+
+每个阶段仍由独立 Skill 负责，不把不同业务逻辑合并。报告复用测试过程中已经展示的图片，不重新占用设备、截图或执行动作。完整规则见 `references/routing.md` 和 `references/evidence-lifecycle.md`。
+
+## 清理和边界
+
+- 不调用 Exec、额外 GUI 模型或隐藏降级链路。
+- 不为了补齐报告重新执行有副作用的操作。
+- 设备 Session、Authoring Session 和临时 APK 由创建它们的阶段负责释放。
+- 不把内部响应、绝对缓存路径或证据 hash 直接展示给用户。

package/dist/assets/integrations/xagent-skill/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: XAgent
-  short_description: Route XAgent device and test requests through one verified CLI/MCP Skill.
-  default_prompt: Check the XAgent CLI, MCP connection, manifest, and route before any side effect; action is the default.
+  short_description: Operate XAgent devices, verify tests, and produce screenshot-backed reports.
+  default_prompt: Understand the user's XAgent goal, run only the required workflow, show key screenshots and visible outcomes, clean up owned resources, and reuse the same evidence in any requested report.

package/dist/assets/integrations/xagent-skill/references/evidence-lifecycle.md

@@ -0,0 +1,23 @@
+# 所见即所得的证据生命周期
+
+用户看到的关键截图和报告中的截图必须来自同一次设备观察。MCP 返回的图片已经压缩到适合 Agent 交互的大小；CLI 在本地短期缓存同一份图片，Report 只复制选中的缓存文件，不再次截图。Author 的证据按 Authoring Session 归档，Run 的证据按 `run:<run_id>` 归档。
+
+## 证据生产
+
+Action、Authoring 和 Run 在返回初始状态、关键后置状态、失败、阻塞或基础设施异常时记录证据。Run 返回的步骤截图可以一次归档，报告阶段只挑选最能证明结果的图片。不要把每个纯导航中间画面都放进报告。
+
+每条证据至少关联：测试项、设备、来源域、screen_id、截图文件、截图 hash、捕获时间和可见证明说明。
+
+## 证据展示
+
+设备动作完成后，向用户展示关键截图和一句可见结果。`PASSED` 只说明设备命令完成；业务状态必须由截图和用户目标共同判断。
+
+## 报告消费
+
+Report 读取证据清单，选择：
+
+- 建立环境的初始图；
+- 每个测试项的一张最终证明图；
+- 解释失败、阻塞或基础设施异常的图。
+
+将选中的图片复制到报告目录下的 `evidence/`，Markdown 只使用相对路径。图片不存在时保留 screen_id 并标记 `INCONCLUSIVE`，不编造图片或重新操作设备。

package/dist/assets/integrations/xagent-skill/references/host-adapters.md

@@ -1,9 +1,18 @@
-# Host Adapters
+# Agent Host 适配
 
-Codex, Claude, Trae, and WorkBuddy may expose different Skill reload and MCP configuration UIs. The package remains identical. The Host must:
+Codex Host 使用 XAgent Skill 包。Host 负责加载入口 Skill、启动对应 MCP 进程，并把 MCP 图片原生展示给用户。
 
-1. Import the directory containing the root `SKILL.md`.
-2. Launch `xagent` as the stdio MCP command with the selected `--profile` and `mcp --mode`.
-3. Reload the Skill/MCP catalog after an upgrade.
+## 用户体验要求
 
-Do not assume that a Host supports structured user-choice UI. If it does not, ask for a plain-text domain choice. `step_confirm` is an Agent Host interaction policy and is never sent to the XAgent API.
+- 工具返回图片时，Host 应展示图片本身，不只显示 URL 或 Base64。
+- 意图明确时不要让用户选择内部 domain。
+- 只有确实存在多个业务目标且会产生不同结果时才询问用户。
+- 用户要求测试报告时，在设备阶段结束并清理资源后继续本地 Report 阶段，不要求用户重新发起命令。
+
+## 运行要求
+
+Host 以当前 npm 安装的 `xagent` 启动 stdio MCP，并使用明确的 Profile。MCP 进程变化、Skill 同步或 npm scope 变化后需要重启 Host。
+
+XAgent 同步只写入自己的 `xagent-skill` 目录，不扫描或覆盖 Host 的其他配置。
+
+`step_confirm` 和 `auto` 是 Authoring 内部交互策略，不是用户必须理解的 XAgent 产品模式。

package/dist/assets/integrations/xagent-skill/references/routing.md

@@ -1,32 +1,22 @@
-# Routing Contract
+# 用户工作流边界
 
-The route is an immutable one-to-one mapping. Select one row before a side effect:
+入口按用户最终目标选择最小的主流程，不向用户展示内部 MCP 参数。
 
-| Domain | MCP mode | Routed Skill | Side effects |
-|---|---|---|---|
-| action | action | xagent-explore-device | yes |
-| author | author | xagent-author-test | yes |
-| run | run | xagent-run-test | yes |
-| analyze | analyze | xagent-analyze-failure | no |
-| repair | repair | xagent-repair-test | yes |
-| report | report | xagent-test-report | no |
+| 用户目标 | 主 Skill | 结束时的用户结果 |
+|---|---|---|
+| 查询、占用、操作设备 | `xagent-explore-device` | 关键截图和可见操作结果 |
+| 编写并验证测试 | `xagent-author-test` | 可继续编辑的测试和验证证据 |
+| 执行已有测试 | `xagent-run-test` | Run 结果和关键步骤证据 |
+| 分析已有失败 | `xagent-analyze-failure` | 失败分类和证据解释 |
+| 修复已有测试 | `xagent-repair-test` | 修复后的测试和验证结果 |
+| 生成报告 | `xagent-test-report` | 带相对图片链接的 Markdown 报告 |
 
-`setup` is reserved for read-only discovery and routing. It is not in the behavior choices.
-
-Use the CLI equivalents:
+当用户明确同时要求测试和报告时，入口只编排顺序：
 
 ```text
-xagent --json integrations options
-xagent --json integrations route action --profile PROFILE
-xagent --json integrations verify-skill PATH_TO_XAGENT_SKILL
+Action / Author / Run → 证据整理 → 资源清理 → Report
 ```
 
-Use the MCP equivalents when available:
-
-```text
-xagent_workflow_options
-xagent_workflow_route(domain="action")
-xagent_skill_load_local(skill="xagent-explore-device")
-```
+如果用户没有要求报告，不要自动进入 Report。若用户后来单独要求报告，只能使用仍可读取的证据；缺失部分标记为 `INCONCLUSIVE`，不能重新执行设备动作补证据。
 
-The selected route's `domain`, `mode`, and `skill` must match exactly. A mismatch is a hard stop, not a fallback.
+不要增加 `action_report`、`run_report` 之类组合 domain。组合是入口的顺序编排，不是新的 MCP 能力。

package/dist/assets/integrations/xagent-skill/references/setup-and-doctor.md

@@ -0,0 +1,26 @@
+# 初始化、自检和同步
+
+这些检查面向 Agent Host 内部执行，正常时用一句话完成，不向用户展示 JSON、hash 或 Session 细节。
+
+## 检查顺序
+
+1. `xagent doctor --json`：检查本地配置、默认 Profile 和凭证来源。
+2. `xagent integrations doctor --host <host> --json`：检查 Host Skill、CLI 版本、Skill 内容、路由版本和 MCP 配置候选。
+3. 需要在线鉴权或权限诊断时才调用 `xagent auth status`。
+
+状态解释：
+
+| 状态 | 用户可见处理 |
+|---|---|
+| `OK` | 直接执行请求 |
+| `NEED_INIT` | 引导用户完成一次 XAgent 初始化 |
+| `NEED_AUTH` | 引导用户登录或配置指定 Profile |
+| `NEED_SYNC` | 同步 XAgent 自己的 Skill 文件 |
+| `NEED_UPGRADE` | 升级 CLI/Skill 后重新检查 |
+| `NEED_RESTART` | 提示重启 Agent Host/MCP，然后继续 |
+
+`xagent init` 只负责 Profile 和服务地址初始化；`integrations sync` 只负责从当前 npm 包同步 XAgent Skill。不要把两者混成一个不可逆的安装动作。
+
+## 同步来源
+
+npm 包是 XAgent Skill 的唯一发布源。同步只写入 XAgent 自己的目录，不覆盖 Host 配置。同步后必须重新加载 Skill，并在 MCP 命令路径变化时重启对应 MCP。

package/dist/assets/skills/xagent-analyze-failure/SKILL.md

@@ -1,13 +1,25 @@
 ---
 name: xagent-analyze-failure
-description: Read-only analysis of an existing XAgent Run or Authoring Attempt result. Use when the user explicitly asks to analyze, explain, or classify a failure without side effects. Do not use to run, retry, cancel, author, repair, or directly control a device.
+description: Read and classify an existing XAgent Run or Authoring Attempt without side effects. Use when the user asks why a test failed, wants evidence classification, or requests a failure explanation. Do not use to run, retry, cancel, edit, repair, or control a device.
 ---
 
-# Analyze An XAgent Failure
+# 分析 XAgent 失败
 
-1. Read the explicit Run or Attempt result, or query it through CLI/MCP when the ID and permission are available.
-2. Classify the outcome using [failure-classification.md](references/failure-classification.md): separate schema/configuration/authentication failures, test behavior failures, infrastructure failures, cancellation, and timeout.
-3. Report the failing device, step index/action, public message, and available Artifact evidence. Do not invent an upstream cause absent from public output.
-4. State whether evidence indicates a transient infrastructure condition or a test-behavior problem. Do not turn that classification into a retry, edit, or workflow change.
+本 Skill 是只读诊断流程。输入必须是用户明确给出的 Run、Attempt 或公开结果；没有明确对象时只说明缺少哪项信息，不猜测上游原因。
+
+## 分析步骤
+
+1. 读取指定 Run 或 Attempt 的公开状态、失败步骤、消息和 Artifacts。
+2. 按 `references/failure-classification.md` 区分 schema/configuration、鉴权、测试行为、设备或网络基础设施、取消和超时。
+3. 输出设备、步骤序号、动作、公开错误、时间和可用证据。
+4. 说明证据支持的是测试行为问题、临时基础设施问题还是无法确认；没有证据时明确标记未知。
+
+## 结果约束
+
+分析结论不等同于修复方案。不要把基础设施故障改写成应用缺陷，也不要把一次 Action 或 Attempt 的成功状态直接解释成业务通过。
+
+## 严格边界
 
 This capability is strictly read-only. It must not modify files, create or cancel a Run, retry an Attempt, acquire or control a device, create a Draft or Revision, recommend or name another Skill, or automatically hand off. Only a newer explicit user request can select a different domain.
+
+本阶段不会自动切换、加载或进入另一个工作流；后续阶段必须由入口按用户已明确的目标顺序编排。

package/dist/assets/skills/xagent-author-test/SKILL.md

@@ -1,19 +1,35 @@
 ---
 name: xagent-author-test
-description: Create a new XAgent YAML test from an explicit script-authoring request and incrementally verify it on one real device. Use when the user asks to write, create, or generate a test/YAML from a goal or artifact. Do not use for action mode, direct device control, running unchanged YAML, read-only analysis, or repair without explicit edit authorization.
+description: Create and verify a new XAgent test from a user goal or selected artifact. Use when the user asks to write, create, generate, or iteratively validate a new test. Do not use for direct device action, unchanged test execution, read-only failure analysis, or repair without explicit authorization.
 ---
 
-# Author An XAgent Test
+# 编写 XAgent 测试
 
-1. Resolve the execution mode (`step_confirm` or `auto`) and input source (`goal` or `artifact`) before creating cloud resources. Read [interaction-modes.md](references/interaction-modes.md), [authoring-workflow.md](references/authoring-workflow.md), and [host-interaction-adapters.md](references/host-interaction-adapters.md).
-2. Create a local authoring workspace under `.xagent/authoring/<session-id>/` with `draft.yaml`, `state.json`, and numbered checkpoints. Then create one Session for an explicit device ID and observe the device.
-3. Read [script-format.md](references/script-format.md) before drafting. Build the working YAML one step at a time: observe the current device state, author the next step, validate the complete snapshot locally, save a checkpoint, then call `xagent_authoring_draft_step_execute`. Add the following step only after the returned evidence is understood.
-4. After each Draft Attempt, show its status and available Artifacts. In `step_confirm`, present a continue-or-adjust choice before the next side effect. In `auto`, continue a successful Attempt without prompting; stop on failure, ambiguity, or new user input.
-5. When the user provides a new instruction, save the current state, re-observe the device, reconcile the required entry state, and revise only invalid authored steps before appending the next step. Read [interactive-steering.md](references/interactive-steering.md) for goal-change scope and state-recovery rules.
-6. Pair every business-critical action with a nearby `waitFor` or `assert` for the expected visible outcome. Use `if` branches for optional UI interruptions that may be absent.
-7. After the user confirms the finished YAML, validate it once more, create exactly one formal Revision with `xagent_authoring_revision_create`, then Complete the Session.
-8. Keep the Session lease alive while the workflow spans user waits or multiple CLI commands. MCP performs best-effort renewal before side effects; a manual multi-command workflow must run `xagent authoring keepalive <sessionId>` (or `xagent device keepalive <sessionId>`). Cancel the Session explicitly whenever authoring stops early. See the Device Occupancy Lifecycle in [authoring-workflow.md](references/authoring-workflow.md).
+本 Skill 负责把用户明确的测试目标逐步整理成可执行的 XAgent YAML，并在一台明确设备上验证每一步。它是独立的编写流程，不负责直接操作模式、既有测试执行、失败分析或修复。
 
-The local Agent generates and corrects the YAML. XAgent validates, records Attempts and the single Revision, and executes on the device.
+## 进入条件
 
-This capability may create local YAML, execute Draft Steps, and create one confirmed final Revision. It must not use the scriptless Action workflow, create a formal Run, repair an existing failed test without explicit repair intent, or automatically hand off to another Skill. `step_confirm` and `auto` only control confirmation inside Author and never override a user-selected action mode.
+1. 确认用户要新建测试，并确定输入是自然语言目标还是用户指定的已有材料。
+2. 读取 `references/interaction-modes.md`、`references/authoring-workflow.md`、`references/script-format.md` 和 `references/host-interaction-adapters.md`。
+3. 在产生云端副作用前，确认设备、应用和交互策略；多项匹配时让用户明确选择。
+
+## 编写循环
+
+1. 创建本地工作区，保存完整 `draft.yaml`、状态和编号检查点。
+2. 创建一个 Authoring Session，在同一 Session 内观察设备初始状态。
+3. 每次只追加一个经过验证的步骤：读取当前画面、生成候选 YAML、做本地校验、保存检查点、执行 Draft Step。
+4. 向用户展示每次 Attempt 的状态、可见结果和关键截图。`step_confirm` 在副作用前等待确认，`auto` 只在结果清晰且成功时继续。
+5. 用户改变目标时先保存当前状态，在同一 Session 重新观察并只修正受影响的步骤。
+6. 业务关键动作必须有附近的 `waitFor` 或 `assert`，可选弹窗使用条件分支表达。
+
+## 完成和清理
+
+用户确认最终行为后，完整校验 YAML，创建一个正式 Revision，然后完成并释放 Session。若同一请求还要求报告，先保留已返回的证据，释放资源，再进入只读 Report 阶段。
+
+Session 跨越用户等待或多次命令时保持租约；手工流程使用 `xagent authoring keepalive <sessionId>`。提前停止必须显式取消 Session。不要把内部 Session、screen_id、幂等键或缓存路径展示给用户。
+
+## 严格边界
+
+本流程可以创建本地 YAML、执行 Draft Step 并创建一个确认后的 Revision。Do not use for action mode or the scriptless Action workflow. Do not create a formal Run. Do not repair an existing failed test without explicit repair intent. Do not silently enter another workflow. A report requested in the same task is a later read-only evidence phase. `step_confirm` and `auto` only control confirmation inside Author and never override a user-selected action mode.
+
+本阶段不会自动切换、加载或进入另一个工作流；后续阶段必须由入口按用户已明确的目标顺序编排。

package/dist/assets/skills/xagent-author-test/references/host-interaction-adapters.md

@@ -21,9 +21,7 @@ Do not send Host, model, mode, prompt, or interaction-capability metadata to XAg
 |---|---|---|
 | Codex Plan mode | `request_user_input` when exposed and permitted | Present native choices. Do not promise that Plan mode permits device side effects; inspect the active Tool policy before execution. |
 | Codex Default mode | Text fallback | Do not call `request_user_input` when the Host reports it unavailable in Default mode. Show the one-time Plan mode notice below. |
-| Claude Code | `AskUserQuestion` when exposed | Present native choices; use text fallback when the Tool is absent or denied. |
-| CodeBuddy Code | `AskUserQuestion` or another documented native choice Tool when exposed | Detect the Tool at runtime; do not infer it from product branding. |
-| WorkBuddy | Any documented native structured-choice Tool when exposed | Probe capabilities at runtime; otherwise use text fallback. |
+| Host with native choices | The documented native choice Tool | Detect the Tool at runtime; otherwise use text fallback. |
 | Other interactive MCP Hosts | Host-native choice Tool when exposed | Use text fallback when no such Tool is callable. |
 | CI/CD or another non-interactive caller | No prompt | Require `auto`; fail before creating a Session if an unresolved interactive choice remains. |
 
@@ -78,4 +76,4 @@ Record Host-specific behavior separately. Passing the XAgent MCP lifecycle does
 
 - Verify Codex Default text fallback and one-time notice.
 - Verify Codex Plan structured choice separately from device-side-effect permission.
-- Verify Claude Code, CodeBuddy Code, and WorkBuddy with their real installed Host versions before declaring those adapters supported.
+- Verify the active Host and exposed choice tools before declaring the adapter supported.

package/dist/assets/skills/xagent-author-test/references/interaction-modes.md

@@ -59,8 +59,7 @@ Use the Host's native structured input only when it is callable now:
 
 - Codex Plan mode: `request_user_input` when exposed and permitted.
 - Codex Default mode: concise text fallback; show the one-time Plan mode notice.
-- Claude Code and CodeBuddy Code: `AskUserQuestion` when exposed.
-- WorkBuddy and other Hosts: a documented native choice when exposed; otherwise text fallback.
+- Hosts exposing a native question tool: use that tool when available; otherwise use the text fallback.
 
 Do not branch on model branding. A Host must actually expose and permit the interaction Tool.
 

package/dist/assets/skills/xagent-cli/SKILL.md

@@ -1,31 +1,33 @@
 ---
 name: xagent-cli
-description: Configure XAgent, inspect Profiles, Tokens, apps, devices, or capabilities, validate existing YAML, and select one workflow when the user has not already selected a mode. Do not use this Skill to override an explicit action, author, run, analyze, or repair request, or to perform those domain workflows itself.
+description: Configure and diagnose the local XAgent CLI, Profile, Skill installation, MCP connection, application catalog, or device catalog. Use for setup and read-only inspection when the user has not requested a device or test workflow. Do not execute actions, write tests, run YAML, repair tests, or generate reports.
 ---
 
-# Use XAgent
+# 配置和检查 XAgent
 
-1. Determine the Agent Host mode from [host-modes.md](references/host-modes.md). Use [cli-commands.md](references/cli-commands.md) for setup and read-only lookup with Shell access. MCP defaults to isolated `action`; every other domain, including report generation, requires its explicit `--mode`. A larger Tool surface is never a substitute for selecting one domain.
-2. Look up application identity when setup or the selected workflow needs it. If `package_id` is unknown, query the project application list. If `package_id` is known but `package_name` is not, query that exact package. Never guess `appPackage` or randomly select one of multiple matches.
-3. Look up devices when setup or the selected workflow needs one and no `device_id` was supplied. Apply server-side filters and return only an explicit match; this routing Skill does not acquire it.
-4. Apply [capability-routing.md](references/capability-routing.md) before selecting a workflow. The newest explicit user mode has highest priority and remains locked until the user explicitly changes it.
-5. Inspect the Principal only for setup, explicit capability inspection, or permission diagnosis. Protected operations authenticate and authorize themselves. Read [permissions.md](references/permissions.md).
-6. When no mode is explicit, recommend exactly one workflow using [failure-routing.md](references/failure-routing.md) and the table below. Do not perform the selected domain here. After handing off, do not load or enter a second workflow unless the user explicitly changes modes.
+本 Skill 是 XAgent 用户流程的准备阶段，只处理本地初始化、自检、同步和只读资源解析。检查正常时用一句“环境已就绪”结束，不展示内部 JSON、版本 hash 或凭证内容。
 
-## Workflow Routing
+## 检查流程
 
-| User request | Skill |
-|---|---|
-| Write a new test from a goal or artifact | `xagent-author-test` |
-| Fix an existing YAML after authorization | `xagent-repair-test` |
-| Run an existing YAML without editing | `xagent-run-test` |
-| Classify a failure without editing | `xagent-analyze-failure` |
-| Explore or diagnose one device step at a time | `xagent-explore-device` |
-| Write a report from already-collected test evidence | `xagent-test-report` |
-| Configure XAgent, inspect apps/devices, or choose an adapter | This Skill |
+1. 运行 `xagent doctor --json`，检查默认 Profile、本地配置和凭证来源。
+2. 运行 `xagent integrations doctor --host <host> --json`，检查 XAgent Skill、CLI 版本和 MCP 重启要求。
+3. 只有用户明确要求权限或在线身份诊断时才调用 `xagent auth status`。
+4. 设备和应用目录仅用于解析用户指定资源；多项匹配时展示名称、系统和状态，不能随机选择。
 
-Scriptless and scripted execution both submit Public Script actions to the authoritative server compiler and the same Exec engine. CLI and MCP are adapters over the same API semantics; neither performs hidden LLM formatting.
+## 状态反馈
 
-This Skill is limited to setup, read-only lookup, validation, and one-time routing. It must not acquire a device Session, execute an action, create or edit YAML, submit a Draft Attempt or Revision, create a Run, or repair a failure.
+- 已配置：说明环境已就绪。
+- 未初始化：引导执行一次 `xagent init`。
+- 缺少登录：说明需要 Developer Token，但不回显 Token。
+- Skill 过期：同步 XAgent Skill 后提示重启 Host。
+- MCP 过期：提示重启 MCP，不自动切换执行链路。
 
-Never print or pass a Developer Token as a command-line argument. Store Personal credentials through the Profile credential store and Project CI credentials in the configured environment variable.
+## 严格边界
+
+- 不执行 `device_acquire`、Action、Draft Step、Revision 或 Run。
+- 不创建、修改或修复 YAML。
+- 不生成报告，也不为了诊断调用截图。
+- 只检查和同步 XAgent 自己的 Skill 目录，不覆盖 Host 配置。
+- 不在本 Skill 中维护第二套用户意图到 MCP Tool 的映射。
+
+明确的设备、测试或报告请求由入口选择对应流程。本 Skill 不自动加载或进入另一个工作流。

package/dist/assets/skills/xagent-cli/references/host-modes.md

@@ -1,21 +1,13 @@
-# Agent Host Modes
+# Agent Host 运行方式
 
-Choose exactly one path for the current environment.
-
-| Environment | Use | Credential source |
+| 环境 | 使用方式 | 凭证来源 |
 |---|---|---|
-| Shell is available | Invoke `xagent` commands directly | Selected Profile |
-| Shell is unavailable, setup or routing is needed | Start `xagent --profile <name> mcp --mode setup` | Selected Profile when cloud lookup is needed |
-| Shell is unavailable, a workflow is explicitly selected | Start `xagent --profile <name> mcp --mode <domain>` with `action`, `author`, `run`, `analyze`, `repair`, or `report` | Selected Profile only for cloud lookup; report is local-only |
-| Local process startup is unavailable | A remote Streamable HTTP MCP is required | Not available in the current release |
-| GitLab or another non-interactive CI runner | Install the Linux CLI package and invoke commands | Explicit project CI Token environment variable |
-
-The stdio Host must launch the executable directly. It must not use a Shell wrapper. Local files remain the Agent Host's responsibility: read an explicitly selected file and send its content to MCP Tools.
-
-Each MCP process exposes one capability domain. Changing domains requires restarting MCP with the new explicit mode after the user requests that change. There is no combined or full mode. A report mode consumes evidence already held by the Agent and does not recover evidence from a device.
-
-The default `xagent-local` MCP is `action` and remains a long-lived stateful device-control process. Direct CLI commands are one-shot calls and must receive the current session, screen and idempotency values explicitly. Do not mix the two invocation styles.
+| 有 Shell | 调用 `xagent` CLI 做初始化、自检和诊断 | 当前 Profile |
+| Agent 设备操作 | 使用 `xagent mcp --mode action` | 当前 Profile |
+| Author、Run、Analyze、Repair | 使用对应隔离 MCP mode | 当前 Profile |
+| Report | 读取已收集结果和本地证据，不操作设备 | 不需要云端凭证，除非读取云端结果 |
+| CI | 安装 npm 包并使用 Project CI Profile | 指定环境变量 |
 
-Before selecting a side-effect domain, present the available behavior choices and identify `action` as the default. The CLI command is `xagent integrations options`; the local `xagent_workflow_options` Tool provides the same list without a Profile or side effect. The user must explicitly select a non-default domain.
+Host 应显示 MCP 原生图片内容，不只向用户返回 screenshot URL。明确请求直接进入对应用户工作流；只有真正歧义时才读取 workflow options。
 
-Do not claim remote MCP support until a public remote endpoint has been delivered and verified.
+CLI、Skill 或 MCP 路径升级后，先运行 `xagent integrations doctor --host <host>`。状态过期时同步 XAgent 自己的 Skill 并重启 Host。不把 MCP 失败自动降级到 Exec。