← 返回帮助中心

AI Agent Skills

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

约 7 分钟

AI Agent Skills 指南

用 Skills + MCP 在 Cursor、Hermes、Claude Desktop 或任意兼容 MCP 的 Agent 里用自然语言跑 CitePath——不必记 API 名称。

Skills 与 MCP

层级 是什么 你要做什么
Skills 分步剧本（SKILL.md） 安装一次；用自然语言说需求
MCP 连接 CitePath 的实时通道（/mcp） 在 Agent 里添加 MCP 服务器

Skills 是说明书，MCP 是引擎。 只有 Skills 无法拉数据或写稿——必须连上 MCP。

你（自然语言）
    → Skill（流程与默认参数）
        → MCP 工具（API 调用）
            → CitePath 后端

配置（约 5 分钟）

第一步 — 连接 MCP（必需）

mcp_servers:
  citepath-geo:
    url: /mcp
    enabled: true
    connect_timeout: 60
    timeout: 300

重启 Agent（Hermes：/reload-mcp）。

第二步 — 安装 Skills

一行命令（Hermes — macOS / Linux / Git Bash）：

curl -fsSL /skills/install.sh | bash

Windows Hermes Desktop（PowerShell）：

irm /skills/install.ps1 | iex

从 GitHub：

curl -fsSL https://raw.githubusercontent.com/Adaku10000/citepath/main/skills/hermes/install.sh | bash

Skill 清单：/skills/manifest.json

8 个 Skills（怎么说）

对话里不必点名 Skill——Agent 会自动选。示例：

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

默认写稿路径

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

典型流程

  1. 连接 MCP
  2. 安装 Skills
  3. 自然语言提问
  4. Agent 选择 Skill + MCP 工具
  5. 审阅草稿 / 报告
  6. 仅当用户要求发布 → citepath-geo-publish / publish_compose

积分

  • 积分 → 审计、写稿、自动化会消耗 CitePath 积分。

排障

现象 处理
Agent 说 MCP 未连接 按上文添加 citepath-geo MCP 配置并 /reload-mcp
401 / 鉴权失败 确认 citepath-geo MCP 配置块，然后 /reload-mcp
insufficient_credits 在站点计费页充值积分

更多