入门指南

Agent Skills

Agent Skills 规范 Skills 目录 (JSON)

使用 Agent Skills 进行 AI 辅助的 MCP 服务器开发。让 AI 帮助你在 Nuxt 应用中设置、创建、审查和排查 MCP 服务器。

Nuxt MCP Toolkit 包含代理技能（agent skills），可帮助 AI 助手在你的 Nuxt 应用中构建、审查和排查 MCP 服务器。

本文档站点使用 Docus 构建，它遵循 Agent Skills 发现约定，将技能发布在 /.well-known/skills/ 路径下。这使得 skills CLI 能够从下方的生产环境 URL 安装它们。

什么是 Agent Skills？

Agent Skills 是一种用于打包 AI 助手能力的开放规范。技能包括：

领域知识：MCP 工具、资源和提示词的最佳实践
引导式开发：逐步指导创建和配置 MCP 服务器
代码审查：识别反模式并提出改进建议
故障排查：诊断自动导入、端点和验证方面的常见问题

可用技能

技能	描述
`skills/manage-mcp`	在 Nuxt 中设置、创建、审查、排查和测试 MCP 服务器

安装技能

兼容的代理（如 Cursor、Claude Code 等）可以自动发现并使用这些技能。

从本站的生产环境 URL 安装（推荐）：

Terminal

npx skills add https://mcp-toolkit.nuxt.dev

CLI 会从 /.well-known/skills/index.json 获取目录，并安装 manage-mcp 技能及其参考文件。对于拉取请求（PR）预览，请使用相同的命令并替换为你的预览部署 URL（Docus：预览与版本控制）。

技能功能

设置与配置

该技能将指导你完成：

安装 @nuxtjs/mcp-toolkit 到你的 Nuxt 应用中
配置 nuxt.config.ts 中的 MCP 选项
创建 server/mcp/ 目录结构
验证 MCP 端点是否可访问

创建定义

该技能帮助你构建：

工具（Tools）：AI 助手可调用的函数，包含 Zod 验证和错误处理
资源（Resources）：通过 URI 暴露的只读数据（静态或带模板的动态数据）
提示词（Prompts）：带有动态参数的可复用消息模板
中间件（Middleware）：身份验证、速率限制、日志记录和 CORS 处理器

审查与审计

该技能会分析你的代码库以查找：

缺少描述：工具或资源缺乏清晰的描述
验证薄弱：Zod 字段缺少 .describe()
错误处理缺失：错误响应中缺少 isError: true
安全问题：资源或工具中暴露了敏感数据
性能问题：高开销操作缺少缓存

故障排查

该技能可诊断：

自动导入失效：模块配置和文件放置问题
端点无法访问：服务器配置和路由问题
验证错误：模式不匹配和类型问题
工具未被发现：文件命名、导出和目录结构问题

使用 Evals 进行测试

该技能帮助你：

配置 Evalite 以进行 MCP 工具选择测试
编写评估场景以验证工具选择
配置 CI/CD 集成以实现自动化测试

示例提示词

向你的 AI 助手提问：

Prompt

在我的 Nuxt 应用中设置一个 MCP 服务器

Prompt

创建一个工具以从我的数据库获取用户数据

Prompt

审查我的 MCP 实现是否符合最佳实践

Prompt

我的自动导入不起作用，帮我排查一下

Prompt

为我的 MCP 工具创建评估测试

技能结构

在 mcp-toolkit 仓库中，技能源文件位于 docs 应用下：

apps/docs/skills/
└── manage-mcp/
    ├── SKILL.md              # 主要技能说明
    └── references/
        ├── middleware.md     # 中间件模式与示例
        ├── tools.md          # 工具示例
        ├── resources.md      # 资源示例
        ├── prompts.md        # 提示词示例
        ├── testing.md        # 使用 Evalite 的测试指南
        └── troubleshooting.md # 故障排查指南

部署后的文件将在 mcp-toolkit.nuxt.dev 上以 /.well-known/skills/manage-mcp/... 路径提供服务。