Ardot MCP 是一个通过受管理的 ardot-mcp-cli 门面，执行 Ardot 设计文件相关操作的技能。它用确定性的 JSON CLI 统一处理 Ardot 端点、OAuth 凭据与绑定、脱敏后的就绪状态，以及任务验收。该技能固定拥有 UXC 0.22.0 二进制；同一用户下的 UXC 守护进程位于 $HOME/.uxc，各技能共享，不应允许其他技能在同一机器上静默安装不同版本的 UXC。
用途方面，该技能用于安装或修复 Ardot UXC 门面与 OAuth 绑定，在多个代理之间发现共享 CLI 并做脱敏就绪检查，以及把应通过 ardot-mcp-cli 执行的设计任务交给它，而不是使用临时性的原生工具。宿主原生 Ardot MCP（例如 Grok ardot-remote）仅作为明确的兼容路径，不是默认的共享 CLI 路径。
使用方式上，用户只需记住 /ardot-mcp。不带任务的调用视为仅做就绪检查；带设计任务的调用则是就绪检查加任务执行。所有辅助脚本应使用 zsh 调用，例如 zsh scripts/uxc-readiness.zsh；在 bash 下使用 set -u 与 ${0:A:h} 会因 A: unbound variable 中止。仅做就绪检查时，运行 zsh scripts/uxc-readiness.zsh，它调用共享的 search_style_guide，丢弃目录候选，只打印有界状态字段。就绪检查加任务时，运行 zsh scripts/uxc-readiness.zsh --private-result 一次，将 JSON 保持私有，并在设计操作前复用该当轮证明。若就绪检查报告缺少 OAuth 或认证失败，按 references/oauth-and-binding.md 执行 OAuth 交接，然后重试一次就绪检查。若受管理 CLI 不存在，只通过本技能的脚本安装并链接，不要回退到 PATH 上无归属的 uxc。
运行时固定链路为：受管理的 ardot-mcp-cli → 固定拥有的 UXC 0.22.0 → 面向 ardot.tencent.com/mcp 的 UXC OAuth 凭据与绑定 → Ardot MCP HTTP 端点。固定值包括：端点为 https://ardot.tencent.com/mcp，链接名为 ardot-mcp-cli，凭据/绑定 id 为 ardot-mcp，默认作用域为 mcp:use，默认安装/链接目录为 ${XDG_DATA_HOME:-$HOME/.local/share}/ardot-mcp，二进制所有者为 ardot-mcp。由于 HTTP MCP 没有昂贵的 stdio 子进程，该技能不设置 --daemon-exclusive；会话复用元数据仍可能出现，但不应虚构独占键。
安装序列需在用户授权本地安装与 OAuth 后执行：先运行 zsh scripts/install-uxc.zsh，再运行 zsh scripts/setup-uxc-link.zsh，然后按 references/oauth-and-binding.md 启动并完成 OAuth，最后运行两次 zsh scripts/uxc-readiness.zsh 进行安装验收。zsh scripts/install-uxc.zsh --manifest 只打印固定版本信息而不下载。就绪后的典型任务操作包括 ardot-mcp-cli -h、ardot-mcp-cli open_design fileUrl='https://ardot.tencent.com/file/<id>'、ardot-mcp-cli fetch_editor_state fileUrl='https://ardot.tencent.com/file/<id>' includeSchema=false includeGeneralEditInstructions=false 以及 ardot-mcp-cli batch_read fileUrl='https://ardot.tencent.com/file/<id>'，参数名应以 ardot-mcp-cli <operation> -h 确认。除非用户要求，否则不应打印 OAuth 令牌、原始就绪目录或无关的设计负载。
验收状态分为：FACADE_READY（拥有二进制与链接约定通过）、TRANSPORT_READY（通过 ardot-mcp-cli 完成脱敏的 search_style_guide）、TASK_ACCEPTANCE（请求的 Ardot 操作完成）、NATIVE_COMPAT（仅在保留时使用宿主原生 Ardot MCP 调用）。未证实的层级应标为 UNVERIFIED，并指出一个下一步操作。更多关于所有权、固定版本与证据边界的内容见 references/uxc-facade.md。
适用场景包括：安装或修复 Ardot UXC 门面与 OAuth 绑定；跨代理发现共享 CLI 并做脱敏就绪检查；需要经 ardot-mcp-cli 而非临时原生工具执行的设计任务。限制方面，该技能以用户授权本地安装和 OAuth 为前提，不默认使用宿主原生 Ardot MCP，且仅在用户明确要求或受阻后批准时使用原生兼容模式；仅凭就绪检查不能声称设计任务已验证，必须待所请求的 Ardot 操作完成后才能标记为 VERIFIED。