[{"data":1,"prerenderedAt":758},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-agent-skills":139,"-getting-started-agent-skills-surround":753},[4,40,65,110],{"title":5,"path":6,"stem":7,"children":8,"page":39},"入门指南","\u002Fgetting-started","1.getting-started",[9,14,19,24,29,34],{"title":10,"path":11,"stem":12,"icon":13},"简介","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-book-open",{"title":15,"path":16,"stem":17,"icon":18},"安装","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"配置","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F3.configuration","i-lucide-settings",{"title":25,"path":26,"stem":27,"icon":28},"MCP Inspector","\u002Fgetting-started\u002Finspector","1.getting-started\u002F4.inspector","i-lucide-circuit-board",{"title":30,"path":31,"stem":32,"icon":33},"连接","\u002Fgetting-started\u002Fconnection","1.getting-started\u002F5.connection","i-lucide-plug",{"title":35,"path":36,"stem":37,"icon":38},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F6.agent-skills","i-lucide-sparkles",false,{"title":41,"path":42,"stem":43,"children":44,"page":39},"核心概念","\u002Fcore-concepts","2.core-concepts",[45,50,55,60],{"title":46,"path":47,"stem":48,"icon":49},"工具","\u002Fcore-concepts\u002Ftools","2.core-concepts\u002F2.tools","i-lucide-wrench",{"title":51,"path":52,"stem":53,"icon":54},"资源","\u002Fcore-concepts\u002Fresources","2.core-concepts\u002F3.resources","i-lucide-package",{"title":56,"path":57,"stem":58,"icon":59},"提示词 (Prompts)","\u002Fcore-concepts\u002Fprompts","2.core-concepts\u002F4.prompts","i-lucide-message-square",{"title":61,"path":62,"stem":63,"icon":64},"处理器 (Handlers)","\u002Fcore-concepts\u002Fhandlers","2.core-concepts\u002F5.handlers","i-lucide-server",{"title":66,"path":67,"stem":68,"children":69,"page":39},"进阶主题","\u002Fadvanced","3.advanced",[70,75,80,85,90,95,100,105],{"title":71,"path":72,"stem":73,"icon":74},"自定义路径","\u002Fadvanced\u002Fcustom-paths","3.advanced\u002F1.custom-paths","i-lucide-folder",{"title":76,"path":77,"stem":78,"icon":79},"中间件","\u002Fadvanced\u002Fmiddleware","3.advanced\u002F2.middleware","i-lucide-shield",{"title":81,"path":82,"stem":83,"icon":84},"TypeScript","\u002Fadvanced\u002Ftypescript","3.advanced\u002F3.typescript","i-lucide-type",{"title":86,"path":87,"stem":88,"icon":89},"钩子","\u002Fadvanced\u002Fhooks","3.advanced\u002F4.hooks","i-lucide-webhook",{"title":91,"path":92,"stem":93,"icon":94},"MCP 评估","\u002Fadvanced\u002Fevals","3.advanced\u002F5.evals","i-lucide-flask-conical",{"title":96,"path":97,"stem":98,"icon":99},"会话 (Sessions)","\u002Fadvanced\u002Fsessions","3.advanced\u002F6.sessions","i-lucide-database",{"title":101,"path":102,"stem":103,"icon":104},"动态定义","\u002Fadvanced\u002Fdynamic-definitions","3.advanced\u002F7.dynamic-definitions","i-lucide-toggle-right",{"title":106,"path":107,"stem":108,"icon":109},"代码模式 (Code Mode)","\u002Fadvanced\u002Fcode-mode","3.advanced\u002F8.code-mode","i-lucide-code",{"title":111,"path":112,"stem":113,"children":114,"page":39},"示例","\u002Fexamples","4.examples",[115,120,125,130,135],{"title":116,"path":117,"stem":118,"icon":119},"身份验证","\u002Fexamples\u002Fauthentication","4.examples\u002F1.authentication","i-lucide-shield-check",{"title":121,"path":122,"stem":123,"icon":124},"API 集成","\u002Fexamples\u002Fapi-integration","4.examples\u002F2.api-integration","i-lucide-globe",{"title":126,"path":127,"stem":128,"icon":129},"常见模式","\u002Fexamples\u002Fcommon-patterns","4.examples\u002F3.common-patterns","i-lucide-lightbulb",{"title":131,"path":132,"stem":133,"icon":134},"文件操作","\u002Fexamples\u002Ffile-operations","4.examples\u002F4.file-operations","i-lucide-file",{"title":136,"path":137,"stem":138,"icon":59},"提示词示例","\u002Fexamples\u002Fprompt-examples","4.examples\u002F5.prompt-examples",{"id":140,"title":35,"body":141,"description":738,"extension":739,"links":740,"meta":749,"navigation":750,"path":36,"seo":751,"stem":37,"__hash__":752},"docs\u002F1.getting-started\u002F6.agent-skills.md",{"type":142,"value":143,"toc":713},"minimark",[144,148,183,188,195,224,227,257,260,263,266,295,314,317,321,324,358,361,364,390,393,396,434,436,439,465,469,472,483,486,489,504,515,526,537,548,551,560,568,581,584,587,591,605,609,620,624,635,639,650,654,665,669,683,686,709],[145,146,147],"p",{},"Nuxt MCP Toolkit 包含代理技能（agent skills），可帮助 AI 助手在你的 Nuxt 应用中构建、审查和排查 MCP 服务器。",[145,149,150,151,158,159,164,165,173,174,182],{},"本文档站点使用 ",[152,153,157],"a",{"href":154,"rel":155},"https:\u002F\u002Fdocus.dev",[156],"nofollow","Docus"," 构建，它遵循 ",[152,160,163],{"href":161,"rel":162},"https:\u002F\u002Fdocus.dev\u002Fen\u002Fai\u002Fskills",[156],"Agent Skills 发现"," 约定，将技能发布在 ",[152,166,169],{"href":167,"rel":168},"https:\u002F\u002Fmcp-toolkit.nuxt.dev\u002F.well-known\u002Fskills\u002Findex.json",[156],[170,171,172],"code",{},"\u002F.well-known\u002Fskills\u002F"," 路径下。这使得 ",[152,175,178,181],{"href":176,"rel":177},"https:\u002F\u002Fagentskills.io",[156],[170,179,180],{},"skills"," CLI"," 能够从下方的生产环境 URL 安装它们。",[184,185,187],"h2",{"id":186},"什么是-agent-skills","什么是 Agent Skills？",[145,189,190,194],{},[152,191,35],{"href":192,"rel":193},"https:\u002F\u002Fagentskills.io\u002F",[156]," 是一种用于打包 AI 助手能力的开放规范。技能包括：",[196,197,198,206,212,218],"ul",{},[199,200,201,205],"li",{},[202,203,204],"strong",{},"领域知识","：MCP 工具、资源和提示词的最佳实践",[199,207,208,211],{},[202,209,210],{},"引导式开发","：逐步指导创建和配置 MCP 服务器",[199,213,214,217],{},[202,215,216],{},"代码审查","：识别反模式并提出改进建议",[199,219,220,223],{},[202,221,222],{},"故障排查","：诊断自动导入、端点和验证方面的常见问题",[184,225,226],{"id":226},"可用技能",[228,229,230,243],"table",{},[231,232,233],"thead",{},[234,235,236,240],"tr",{},[237,238,239],"th",{},"技能",[237,241,242],{},"描述",[244,245,246],"tbody",{},[234,247,248,254],{},[249,250,251],"td",{},[170,252,253],{},"skills\u002Fmanage-mcp",[249,255,256],{},"在 Nuxt 中设置、创建、审查、排查和测试 MCP 服务器",[184,258,259],{"id":259},"安装技能",[145,261,262],{},"兼容的代理（如 Cursor、Claude Code 等）可以自动发现并使用这些技能。",[145,264,265],{},"从本站的生产环境 URL 安装（推荐）：",[267,268,274],"pre",{"className":269,"code":270,"filename":271,"language":272,"meta":273,"style":273},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx skills add https:\u002F\u002Fmcp-toolkit.nuxt.dev\n","Terminal","bash","",[170,275,276],{"__ignoreMap":273},[277,278,281,285,289,292],"span",{"class":279,"line":280},"line",1,[277,282,284],{"class":283},"sBMFI","npx",[277,286,288],{"class":287},"sfazB"," skills",[277,290,291],{"class":287}," add",[277,293,294],{"class":287}," https:\u002F\u002Fmcp-toolkit.nuxt.dev\n",[145,296,297,298,304,305,308,309,313],{},"CLI 会从 ",[152,299,301],{"href":167,"rel":300},[156],[170,302,303],{},"\u002F.well-known\u002Fskills\u002Findex.json"," 获取目录，并安装 ",[170,306,307],{},"manage-mcp"," 技能及其参考文件。对于拉取请求（PR）预览，请使用相同的命令并替换为你的预览部署 URL（",[152,310,312],{"href":161,"rel":311},[156],"Docus：预览与版本控制","）。",[184,315,316],{"id":316},"技能功能",[318,319,320],"h3",{"id":320},"设置与配置",[145,322,323],{},"该技能将指导你完成：",[196,325,326,335,343,352],{},[199,327,328,330,331,334],{},[202,329,15],{}," ",[170,332,333],{},"@nuxtjs\u002Fmcp-toolkit"," 到你的 Nuxt 应用中",[199,336,337,330,339,342],{},[202,338,20],{},[170,340,341],{},"nuxt.config.ts"," 中的 MCP 选项",[199,344,345,330,348,351],{},[202,346,347],{},"创建",[170,349,350],{},"server\u002Fmcp\u002F"," 目录结构",[199,353,354,357],{},[202,355,356],{},"验证"," MCP 端点是否可访问",[318,359,360],{"id":360},"创建定义",[145,362,363],{},"该技能帮助你构建：",[196,365,366,372,378,384],{},[199,367,368,371],{},[202,369,370],{},"工具（Tools）","：AI 助手可调用的函数，包含 Zod 验证和错误处理",[199,373,374,377],{},[202,375,376],{},"资源（Resources）","：通过 URI 暴露的只读数据（静态或带模板的动态数据）",[199,379,380,383],{},[202,381,382],{},"提示词（Prompts）","：带有动态参数的可复用消息模板",[199,385,386,389],{},[202,387,388],{},"中间件（Middleware）","：身份验证、速率限制、日志记录和 CORS 处理器",[318,391,392],{"id":392},"审查与审计",[145,394,395],{},"该技能会分析你的代码库以查找：",[196,397,398,404,413,422,428],{},[199,399,400,403],{},[202,401,402],{},"缺少描述","：工具或资源缺乏清晰的描述",[199,405,406,409,410],{},[202,407,408],{},"验证薄弱","：Zod 字段缺少 ",[170,411,412],{},".describe()",[199,414,415,418,419],{},[202,416,417],{},"错误处理缺失","：错误响应中缺少 ",[170,420,421],{},"isError: true",[199,423,424,427],{},[202,425,426],{},"安全问题","：资源或工具中暴露了敏感数据",[199,429,430,433],{},[202,431,432],{},"性能问题","：高开销操作缺少缓存",[318,435,222],{"id":222},[145,437,438],{},"该技能可诊断：",[196,440,441,447,453,459],{},[199,442,443,446],{},[202,444,445],{},"自动导入失效","：模块配置和文件放置问题",[199,448,449,452],{},[202,450,451],{},"端点无法访问","：服务器配置和路由问题",[199,454,455,458],{},[202,456,457],{},"验证错误","：模式不匹配和类型问题",[199,460,461,464],{},[202,462,463],{},"工具未被发现","：文件命名、导出和目录结构问题",[318,466,468],{"id":467},"使用-evals-进行测试","使用 Evals 进行测试",[145,470,471],{},"该技能帮助你：",[196,473,474,477,480],{},[199,475,476],{},"配置 Evalite 以进行 MCP 工具选择测试",[199,478,479],{},"编写评估场景以验证工具选择",[199,481,482],{},"配置 CI\u002FCD 集成以实现自动化测试",[318,484,485],{"id":485},"示例提示词",[145,487,488],{},"向你的 AI 助手提问：",[490,491,492],"code-collapse",{},[267,493,498],{"className":494,"code":495,"filename":496,"language":497,"meta":273,"style":273},"language-txt shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","在我的 Nuxt 应用中设置一个 MCP 服务器\n","Prompt","txt",[170,499,500],{"__ignoreMap":273},[277,501,502],{"class":279,"line":280},[277,503,495],{},[490,505,506],{},[267,507,509],{"className":494,"code":508,"filename":496,"language":497,"meta":273,"style":273},"创建一个工具以从我的数据库获取用户数据\n",[170,510,511],{"__ignoreMap":273},[277,512,513],{"class":279,"line":280},[277,514,508],{},[490,516,517],{},[267,518,520],{"className":494,"code":519,"filename":496,"language":497,"meta":273,"style":273},"审查我的 MCP 实现是否符合最佳实践\n",[170,521,522],{"__ignoreMap":273},[277,523,524],{"class":279,"line":280},[277,525,519],{},[490,527,528],{},[267,529,531],{"className":494,"code":530,"filename":496,"language":497,"meta":273,"style":273},"我的自动导入不起作用，帮我排查一下\n",[170,532,533],{"__ignoreMap":273},[277,534,535],{"class":279,"line":280},[277,536,530],{},[490,538,539],{},[267,540,542],{"className":494,"code":541,"filename":496,"language":497,"meta":273,"style":273},"为我的 MCP 工具创建评估测试\n",[170,543,544],{"__ignoreMap":273},[277,545,546],{"class":279,"line":280},[277,547,541],{},[184,549,550],{"id":550},"技能结构",[145,552,553,554,559],{},"在 ",[152,555,558],{"href":556,"rel":557},"https:\u002F\u002Fgithub.com\u002Fnuxt-modules\u002Fmcp-toolkit",[156],"mcp-toolkit 仓库"," 中，技能源文件位于 docs 应用下：",[267,561,566],{"className":562,"code":564,"language":565},[563],"language-text","apps\u002Fdocs\u002Fskills\u002F\n└── manage-mcp\u002F\n    ├── SKILL.md              # 主要技能说明\n    └── references\u002F\n        ├── middleware.md     # 中间件模式与示例\n        ├── tools.md          # 工具示例\n        ├── resources.md      # 资源示例\n        ├── prompts.md        # 提示词示例\n        ├── testing.md        # 使用 Evalite 的测试指南\n        └── troubleshooting.md # 故障排查指南\n","text",[170,567,564],{"__ignoreMap":273},[145,569,570,571,576,577,580],{},"部署后的文件将在 ",[152,572,575],{"href":573,"rel":574},"https:\u002F\u002Fmcp-toolkit.nuxt.dev",[156],"mcp-toolkit.nuxt.dev"," 上以 ",[170,578,579],{},"\u002F.well-known\u002Fskills\u002Fmanage-mcp\u002F..."," 路径提供服务。",[184,582,583],{"id":583},"参考文档",[145,585,586],{},"该技能包含以下参考文档：",[318,588,590],{"id":589},"middlewaremd","middleware.md",[196,592,593,596,599,602],{},[199,594,595],{},"身份验证模式（API 密钥、JWT）",[199,597,598],{},"速率限制与 CORS 配置",[199,600,601],{},"日志记录与请求追踪",[199,603,604],{},"安全最佳实践",[318,606,608],{"id":607},"toolsmd","tools.md",[196,610,611,614,617],{},[199,612,613],{},"支持各种输入类型的工具定义模式",[199,615,616],{},"错误处理与缓存示例",[199,618,619],{},"实际工具实现案例",[318,621,623],{"id":622},"resourcesmd","resources.md",[196,625,626,629,632],{},[199,627,628],{},"静态与动态资源模式",[199,630,631],{},"文件、API 和数据库资源示例",[199,633,634],{},"URI 模板用法",[318,636,638],{"id":637},"promptsmd","prompts.md",[196,640,641,644,647],{},[199,642,643],{},"静态与动态提示词模式",[199,645,646],{},"多消息对话模板",[199,648,649],{},"代码审查与文档生成器示例",[318,651,653],{"id":652},"testingmd","testing.md",[196,655,656,659,662],{},[199,657,658],{},"Evalite 安装与配置",[199,660,661],{},"测试场景模式",[199,663,664],{},"CI\u002FCD 集成",[318,666,668],{"id":667},"troubleshootingmd","troubleshooting.md",[196,670,671,674,677,680],{},[199,672,673],{},"自动导入解析步骤",[199,675,676],{},"端点调试指南",[199,678,679],{},"验证错误修复",[199,681,682],{},"性能优化建议",[184,684,685],{"id":685},"下一步",[196,687,688,693,698,703],{},[199,689,690,692],{},[152,691,15],{"href":16}," - 开始使用 Nuxt MCP Toolkit",[199,694,695,697],{},[152,696,46],{"href":47}," - 学习如何创建 MCP 工具",[199,699,700,702],{},[152,701,51],{"href":52}," - 通过 MCP 资源暴露数据",[199,704,705,708],{},[152,706,707],{"href":57},"提示词"," - 创建可复用的提示词模板",[710,711,712],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":273,"searchDepth":714,"depth":714,"links":715},2,[716,717,718,719,728,729,737],{"id":186,"depth":714,"text":187},{"id":226,"depth":714,"text":226},{"id":259,"depth":714,"text":259},{"id":316,"depth":714,"text":316,"children":720},[721,723,724,725,726,727],{"id":320,"depth":722,"text":320},3,{"id":360,"depth":722,"text":360},{"id":392,"depth":722,"text":392},{"id":222,"depth":722,"text":222},{"id":467,"depth":722,"text":468},{"id":485,"depth":722,"text":485},{"id":550,"depth":714,"text":550},{"id":583,"depth":714,"text":583,"children":730},[731,732,733,734,735,736],{"id":589,"depth":722,"text":590},{"id":607,"depth":722,"text":608},{"id":622,"depth":722,"text":623},{"id":637,"depth":722,"text":638},{"id":652,"depth":722,"text":653},{"id":667,"depth":722,"text":668},{"id":685,"depth":714,"text":685},"使用 Agent Skills 进行 AI 辅助的 MCP 服务器开发。让 AI 帮助你在 Nuxt 应用中设置、创建、审查和排查 MCP 服务器。","md",[741,747],{"label":742,"icon":743,"to":176,"target":744,"color":745,"variant":746},"Agent Skills 规范","i-lucide-external-link","_blank","neutral","subtle",{"label":748,"icon":743,"to":167,"target":744,"color":745,"variant":746},"Skills 目录 (JSON)",{},{"icon":38},{"title":35,"description":738},"web3eJIOqaieSF5JuVj_Z3BD9V-IaSY7-BgGccOV6us",[754,756],{"title":30,"path":31,"stem":32,"description":755,"icon":33,"children":-1},"将 AI 助手连接到您的 MCP 服务器，并在文档中添加安装按钮。",{"title":46,"path":47,"stem":48,"description":757,"icon":49,"children":-1},"使用 Zod 验证和类型安全创建 MCP 工具。",1775615721144]