← 返回帮助中心

AI Agent Skills

在 Cursor、Hermes、Claude Desktop 中用 Skills 编排 MCP：安装、示例话术与排错。

约 7 分钟

AI Agent Skills 使用指南

通过 Skills + MCP，在 Cursor、Hermes、Claude Desktop 或任意 MCP 兼容 Agent 里用自然语言完成 GEO 审计、品牌监测、写稿与发布——无需记忆 API 名称。

Skills 与 MCP 的关系

层级 是什么 你要做什么
Skills 分步 playbook（SKILL.md） 安装一次，用自然语言对话
MCP 连接 VidAU 的实时通道（https://geo.vidau.ai/mcp） 在 Agent 里添加 MCP 服务器

Skill 是使用说明，MCP 才是引擎。 只装 Skill、不连 MCP，无法查数据、写稿或做审计。

你（自然语言）
    → Skill（工作流与默认值）
        → MCP 工具（API 调用）
            → geo.vidau.ai 后端

安装（约 5 分钟）

第 1 步 — 连接 MCP（必须）

mcp_servers:
  vidau-geo:
    url: https://geo.vidau.ai/mcp
    enabled: true
    connect_timeout: 60
    timeout: 300

保存后重启 Agent（Hermes 可用 /reload-mcp）。

第 2 步 — 安装 Skills

一键安装（Hermes — macOS / Linux / Git Bash）：

curl -fsSL https://geo.vidau.ai/skills/install.sh | bash

Windows Hermes Desktop（PowerShell）：

irm https://geo.vidau.ai/skills/install.ps1 | iex

从 GitHub 安装：

curl -fsSL https://raw.githubusercontent.com/vidaudeveloper/Vidau-Geo-Agent/main/install.sh | bash

irm https://raw.githubusercontent.com/vidaudeveloper/Vidau-Geo-Agent/main/install.ps1 | iex

自动安装提示词： 把 INSTALL_PROMPT.md 里的中文版整段复制到 Agent 对话。

Skill 清单：geo.vidau.ai/skills/manifest.json

8 个 Skill（怎么说就行）

对话里不必手动指定 Skill 名称，Agent 会自动匹配。示例：

目标 示例说法 对应 Skill
GEO 快照 给 https://example.com 做 60 秒 GEO 快照，把 HTML 报告链接给我。 vidau-geo-quick-audit
完整审计 给 https://example.com 做一次完整 GEO 审计。 vidau-geo-full-audit
品牌 KPI 我们品牌这周可见度、引用率、SOV、情感分怎么样？ vidau-geo-brand-insights
写 GEO 文章 帮我们写一篇 GEO 竞品对比文章。 vidau-geo-compose
发布 把刚才写的文章以草稿形式发布到 WordPress。 vidau-geo-publish
仅 Markdown 只要 Markdown 草稿，不要 meta 和 schema。 vidau-geo-write-draft
自动化流水线 走完整自动化：选题、写稿、质检并发布。 vidau-geo-automation
MCP 未连接 （自动） 引导完成 MCP 配置 vidau-geo-mcp-setup

默认写稿路径

优先 vidau-geo-compose（含 meta、schema、SEO 关键词、可选配图、质检）。仅当用户明确要「只要 Markdown、不要 meta/schema」时用 vidau-geo-write-draft。

Compose 编排流程（Skill 内部）

  1. list_brands → 确定品牌（单品牌时静默）
  2. 用户给 topic，或 suggest_topic / generate_topic
  3. suggest_seo_keywords → 把关键词传给 compose
  4. compose_article（默认 language=auto、tone=professional、template_id=simple、image_source=auto）
  5. 在 Content Creation → My Articles 预览（响应含 draftId）
  6. 仅当用户要求发布 → vidau-geo-publish / publish_compose

支持的客户端

客户端 MCP Skills
Hermes ✅ ✅ install.sh / install.ps1 (Windows)
Cursor ✅ ✅ 远程 SKILL.md
Claude Desktop ✅ ✅ 远程 SKILL.md
其他 MCP Agent ✅ ✅ 支持远程 Skill 即可

使用技巧

  • 账号只有一个品牌 → Agent 自动选中，无需追问。
  • 多个品牌 → Agent 用站点名称确认，不会甩 UUID。
  • 发布默认 → WordPress/Shopify 草稿，除非你说「直接上线」。
  • 积分 → 审计、写稿、自动化会消耗 VidAU 积分。
  • MCP 已连接 → Agent 不会反复提示装 MCP，直接执行任务。

常见问题

现象 处理
Agent 说 MCP 未连接 按上文添加 vidau-geo MCP 配置并 /reload-mcp
401 / 鉴权失败 确认 vidau-geo MCP 配置块，然后 /reload-mcp
insufficient_credits 在 geo.vidau.ai 充值积分
missing_seo_keywords 在 GEO 控制台 → Brand 配置关键词库
审计分数是编造的 重新安装 Skills；Agent 必须调 MCP，不能猜
配图被跳过 连接 WordPress；或设置 image_source=none

相关资源