[{"data":1,"prerenderedAt":1174},["ShallowReactive",2],{"app-nav_docs_manual_zh":3,"navigation_docs_manual_zh":134,"-docs-manual-zh-ai-skills":164,"-docs-manual-zh-ai-skills-surround":1169},[4,41,77,109],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":40},"快速入门","i-lucide-rocket","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started","docs\u002Fmanual\u002Fzh\u002F1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"简介","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Fintroduction","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F2.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"安装","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Finstallation","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F3.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"项目结构","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Fproject-structure","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F4.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Studio 模块","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Fstudio","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F5.studio","i-lucide-mouse-pointer-2",{"title":31,"path":32,"stem":33,"icon":34},"迁移","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Fmigration","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F6.migration","i-lucide-replace",{"title":36,"path":37,"stem":38,"icon":39},"故障排除","\u002Fdocs\u002Fmanual\u002Fzh\u002Fgetting-started\u002Ftroubleshooting","docs\u002Fmanual\u002Fzh\u002F1.getting-started\u002F7.troubleshooting","i-lucide-wrench",false,{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":40},"核心概念","i-lucide-brain","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts","docs\u002Fmanual\u002Fzh\u002F2.concepts",[47,52,57,62,67,72],{"title":48,"path":49,"stem":50,"icon":51},"内容编辑","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Fedition","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F2.edition","i-lucide-pencil",{"title":53,"path":54,"stem":55,"icon":56},"配置","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Fconfiguration","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F3.configuration","i-lucide-settings",{"title":58,"path":59,"stem":60,"icon":61},"主题","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Ftheme","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F4.theme","i-lucide-paint-roller",{"title":63,"path":64,"stem":65,"icon":66},"自定义","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Fcustomization","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F5.customization","i-lucide-pen-tool",{"title":68,"path":69,"stem":70,"icon":71},"国际化","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Finternationalization","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F6.internationalization","i-lucide-globe",{"title":73,"path":74,"stem":75,"icon":76},"Nuxt","\u002Fdocs\u002Fmanual\u002Fzh\u002Fconcepts\u002Fnuxt","docs\u002Fmanual\u002Fzh\u002F2.concepts\u002F8.nuxt","i-simple-icons-nuxt",{"title":78,"icon":79,"path":80,"stem":81,"children":82,"page":40},"基础要点","i-lucide-book-open","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials","docs\u002Fmanual\u002Fzh\u002F3.essentials",[83,88,93,98,103],{"title":84,"path":85,"stem":86,"icon":87},"Markdown 语法","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials\u002Fmarkdown-syntax","docs\u002Fmanual\u002Fzh\u002F3.essentials\u002F1.markdown-syntax","i-lucide-heading-1",{"title":89,"path":90,"stem":91,"icon":92},"代码块","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials\u002Fcode-blocks","docs\u002Fmanual\u002Fzh\u002F3.essentials\u002F2.code-blocks","i-lucide-code-xml",{"title":94,"path":95,"stem":96,"icon":97},"组件","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials\u002Fcomponents","docs\u002Fmanual\u002Fzh\u002F3.essentials\u002F3.components","i-lucide-component",{"title":99,"path":100,"stem":101,"icon":102},"图片与嵌入","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials\u002Fimages-embeds","docs\u002Fmanual\u002Fzh\u002F3.essentials\u002F4.images-embeds","i-lucide-image",{"title":104,"path":105,"stem":106,"icon":107,"position":108},"Mermaid 图表","\u002Fdocs\u002Fmanual\u002Fzh\u002Fessentials\u002Fmermaid","docs\u002Fmanual\u002Fzh\u002F3.essentials\u002F5.mermaid","i-lucide-chart-network",5,{"title":110,"icon":111,"path":112,"stem":113,"children":114,"page":40},"AI","i-lucide-sparkles","\u002Fdocs\u002Fmanual\u002Fzh\u002Fai","docs\u002Fmanual\u002Fzh\u002F4.ai",[115,119,124,129],{"title":116,"path":117,"stem":118,"icon":111},"助手","\u002Fdocs\u002Fmanual\u002Fzh\u002Fai\u002Fassistant","docs\u002Fmanual\u002Fzh\u002F4.ai\u002F1.assistant",{"title":120,"path":121,"stem":122,"icon":123},"MCP 服务器","\u002Fdocs\u002Fmanual\u002Fzh\u002Fai\u002Fmcp","docs\u002Fmanual\u002Fzh\u002F4.ai\u002F2.mcp","i-lucide-cpu",{"title":125,"path":126,"stem":127,"icon":128},"Agent 技能","\u002Fdocs\u002Fmanual\u002Fzh\u002Fai\u002Fskills","docs\u002Fmanual\u002Fzh\u002F4.ai\u002F3.skills","i-lucide-wand-sparkles",{"title":130,"path":131,"stem":132,"icon":133},"LLMs 集成","\u002Fdocs\u002Fmanual\u002Fzh\u002Fai\u002Fllms","docs\u002Fmanual\u002Fzh\u002F4.ai\u002F4.llms","i-lucide-message-circle-code",[135,143,151,158],{"title":5,"icon":6,"path":7,"stem":8,"children":136,"page":40},[137,138,139,140,141,142],{"title":11,"path":12,"stem":13,"icon":14},{"title":16,"path":17,"stem":18,"icon":19},{"title":21,"path":22,"stem":23,"icon":24},{"title":26,"path":27,"stem":28,"icon":29},{"title":31,"path":32,"stem":33,"icon":34},{"title":36,"path":37,"stem":38,"icon":39},{"title":42,"icon":43,"path":44,"stem":45,"children":144,"page":40},[145,146,147,148,149,150],{"title":48,"path":49,"stem":50,"icon":51},{"title":53,"path":54,"stem":55,"icon":56},{"title":58,"path":59,"stem":60,"icon":61},{"title":63,"path":64,"stem":65,"icon":66},{"title":68,"path":69,"stem":70,"icon":71},{"title":73,"path":74,"stem":75,"icon":76},{"title":78,"icon":79,"path":80,"stem":81,"children":152,"page":40},[153,154,155,156,157],{"title":84,"path":85,"stem":86,"icon":87},{"title":89,"path":90,"stem":91,"icon":92},{"title":94,"path":95,"stem":96,"icon":97},{"title":99,"path":100,"stem":101,"icon":102},{"title":104,"path":105,"stem":106,"icon":107,"position":108},{"title":110,"icon":111,"path":112,"stem":113,"children":159,"page":40},[160,161,162,163],{"title":116,"path":117,"stem":118,"icon":111},{"title":120,"path":121,"stem":122,"icon":123},{"title":125,"path":126,"stem":127,"icon":128},{"title":130,"path":131,"stem":132,"icon":133},{"id":165,"title":125,"body":166,"config":1163,"description":1164,"extension":306,"links":1163,"meta":1165,"navigation":1166,"path":126,"seo":1167,"stem":127,"__hash__":1168},"docs_manual_zh\u002Fdocs\u002Fmanual\u002Fzh\u002F4.ai\u002F3.skills.md",{"type":167,"value":168,"toc":1144},"minimark",[169,174,195,207,215,218,440,443,449,544,555,566,568,582,664,667,676,712,715,718,721,793,799,802,805,814,830,844,847,850,871,877,880,888,891,1012,1015,1021,1039,1043,1049,1134,1140],[170,171,173],"h2",{"id":172},"关于-agent-技能","关于 Agent 技能",[175,176,177,178,182,183,186,187,194],"p",{},"TockDocs 自动发现 ",[179,180,181],"code",{},"skills\u002F"," 目录中的技能，并在 ",[179,184,185],{},"\u002F.well-known\u002Fskills\u002F"," 下提供服务，遵循 ",[188,189,193],"a",{"href":190,"rel":191},"https:\u002F\u002Fgithub.com\u002Fcloudflare\u002Fagent-skills-discovery-rfc",[192],"nofollow","Cloudflare Agent Skills Discovery RFC","。这使得您的技能可以通过一条命令从任何文档 URL 安装。",[175,196,197,202,203,206],{},[188,198,201],{"href":199,"rel":200},"https:\u002F\u002Fagentskills.io\u002F",[192],"Agent Skills"," 是一种轻量级、开放格式，用于为 AI Agent 提供专业知识和工作流。一个技能是一个包含 YAML frontmatter 的 ",[179,204,205],{},"SKILL.md"," 文件，描述 Agent 可以使用您的产品做什么，以及可选的支持参考文件。",[208,209,210,211,214],"note",{},"当 TockDocs 站点提供技能时，其目录会暴露在 ",[179,212,213],{},"\u002F.well-known\u002Fskills\u002Findex.json","。",[170,216,217],{"id":217},"快速开始",[219,220,221,225,234,280,284,301,403,406,412,415,418,437],"steps",{},[222,223,224],"h3",{"id":224},"创建技能",[175,226,227,228,230,231,233],{},"在 TockDocs 项目根目录添加一个 ",[179,229,181],{}," 目录，并在其中创建包含 ",[179,232,205],{}," 文件的技能子目录：",[235,236,241],"pre",{"className":237,"code":238,"language":239,"meta":240,"style":240},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","my-docs\u002F\n└── skills\u002F\n    └── my-product\u002F\n        └── SKILL.md\n","bash","",[179,242,243,252,262,271],{"__ignoreMap":240},[244,245,248],"span",{"class":246,"line":247},"line",1,[244,249,251],{"class":250},"sBMFI","my-docs\u002F\n",[244,253,255,258],{"class":246,"line":254},2,[244,256,257],{"class":250},"└──",[244,259,261],{"class":260},"sfazB"," skills\u002F\n",[244,263,265,268],{"class":246,"line":264},3,[244,266,267],{"class":250},"    └──",[244,269,270],{"class":260}," my-product\u002F\n",[244,272,274,277],{"class":246,"line":273},4,[244,275,276],{"class":250},"        └──",[244,278,279],{"class":260}," SKILL.md\n",[222,281,283],{"id":282},"编写-skillmd","编写 SKILL.md",[175,285,286,287,292,293,296,297,300],{},"遵循 ",[188,288,291],{"href":289,"rel":290},"https:\u002F\u002Fagentskills.io\u002Fspecification",[192],"agentskills.io 规范","。唯一必填的 frontmatter 字段是 ",[179,294,295],{},"description","——",[179,298,299],{},"name"," 默认使用目录名（如果省略）：",[235,302,307],{"className":303,"code":304,"filename":305,"language":306,"meta":240,"style":240},"language-md shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: my-product\ndescription: 使用 My Product 构建和部署应用。用于创建项目、配置设置或排查问题。\n---\n\n# My Product\n\n## 快速开始\n\n创建一个新项目：\n\n\\`\\`\\`bash\nnpx create-my-product my-app\n\\`\\`\\`\n","skills\u002Fmy-product\u002FSKILL.md","md",[179,308,309,315,326,335,339,345,354,359,368,373,380,385,391,397],{"__ignoreMap":240},[244,310,311],{"class":246,"line":247},[244,312,314],{"class":313},"sMK4o","---\n",[244,316,317,320,323],{"class":246,"line":254},[244,318,299],{"class":319},"swJcz",[244,321,322],{"class":313},":",[244,324,325],{"class":260}," my-product\n",[244,327,328,330,332],{"class":246,"line":264},[244,329,295],{"class":319},[244,331,322],{"class":313},[244,333,334],{"class":260}," 使用 My Product 构建和部署应用。用于创建项目、配置设置或排查问题。\n",[244,336,337],{"class":246,"line":273},[244,338,314],{"class":313},[244,340,341],{"class":246,"line":108},[244,342,344],{"emptyLinePlaceholder":343},true,"\n",[244,346,348,351],{"class":246,"line":347},6,[244,349,350],{"class":313},"# ",[244,352,353],{"class":250},"My Product\n",[244,355,357],{"class":246,"line":356},7,[244,358,344],{"emptyLinePlaceholder":343},[244,360,362,365],{"class":246,"line":361},8,[244,363,364],{"class":313},"## ",[244,366,367],{"class":250},"快速开始\n",[244,369,371],{"class":246,"line":370},9,[244,372,344],{"emptyLinePlaceholder":343},[244,374,376],{"class":246,"line":375},10,[244,377,379],{"class":378},"sTEyZ","创建一个新项目：\n",[244,381,383],{"class":246,"line":382},11,[244,384,344],{"emptyLinePlaceholder":343},[244,386,388],{"class":246,"line":387},12,[244,389,390],{"class":378},"\\`\\`\\`bash\n",[244,392,394],{"class":246,"line":393},13,[244,395,396],{"class":378},"npx create-my-product my-app\n",[244,398,400],{"class":246,"line":399},14,[244,401,402],{"class":378},"\\`\\`\\`\n",[222,404,405],{"id":405},"部署",[175,407,408,409,411],{},"部署您的文档。TockDocs 会自动在 ",[179,410,185],{}," 下提供您的技能。",[222,413,414],{"id":414},"与用户分享",[175,416,417],{},"用户可以通过一条命令安装您的技能：",[235,419,421],{"className":237,"code":420,"language":239,"meta":240,"style":240},"npx skills add https:\u002F\u002Fyour-docs-domain.com\n",[179,422,423],{"__ignoreMap":240},[244,424,425,428,431,434],{"class":246,"line":247},[244,426,427],{"class":250},"npx",[244,429,430],{"class":260}," skills",[244,432,433],{"class":260}," add",[244,435,436],{"class":260}," https:\u002F\u002Fyour-docs-domain.com\n",[175,438,439],{},"CLI 会检测已安装的 Agent（Claude Code、Cursor、Windsurf 等）并将技能安装到所有 Agent 中。",[170,441,442],{"id":442},"目录结构",[175,444,445,446,448],{},"技能目录可以包含 ",[179,447,205],{}," 之外的支持文件：",[235,450,452],{"className":237,"code":451,"language":239,"meta":240,"style":240},"skills\u002F\n└── my-product\u002F\n    ├── SKILL.md              # 必填：指令 + 元数据\n    ├── references\u002F           # 可选：额外文档\n    │   ├── api.md\n    │   └── configuration.md\n    ├── scripts\u002F              # 可选：可执行代码\n    │   └── setup.sh\n    └── assets\u002F               # 可选：模板、模式\n        └── config.template.yaml\n",[179,453,454,459,465,477,487,498,508,518,527,537],{"__ignoreMap":240},[244,455,456],{"class":246,"line":247},[244,457,458],{"class":250},"skills\u002F\n",[244,460,461,463],{"class":246,"line":254},[244,462,257],{"class":250},[244,464,270],{"class":260},[244,466,467,470,473],{"class":246,"line":264},[244,468,469],{"class":250},"    ├──",[244,471,472],{"class":260}," SKILL.md",[244,474,476],{"class":475},"sHwdD","              # 必填：指令 + 元数据\n",[244,478,479,481,484],{"class":246,"line":273},[244,480,469],{"class":250},[244,482,483],{"class":260}," references\u002F",[244,485,486],{"class":475},"           # 可选：额外文档\n",[244,488,489,492,495],{"class":246,"line":108},[244,490,491],{"class":250},"    │",[244,493,494],{"class":260},"   ├──",[244,496,497],{"class":260}," api.md\n",[244,499,500,502,505],{"class":246,"line":347},[244,501,491],{"class":250},[244,503,504],{"class":260},"   └──",[244,506,507],{"class":260}," configuration.md\n",[244,509,510,512,515],{"class":246,"line":356},[244,511,469],{"class":250},[244,513,514],{"class":260}," scripts\u002F",[244,516,517],{"class":475},"              # 可选：可执行代码\n",[244,519,520,522,524],{"class":246,"line":361},[244,521,491],{"class":250},[244,523,504],{"class":260},[244,525,526],{"class":260}," setup.sh\n",[244,528,529,531,534],{"class":246,"line":370},[244,530,267],{"class":250},[244,532,533],{"class":260}," assets\u002F",[244,535,536],{"class":475},"               # 可选：模板、模式\n",[244,538,539,541],{"class":246,"line":375},[244,540,276],{"class":250},[244,542,543],{"class":260}," config.template.yaml\n",[175,545,546,547,550,551,554],{},"所有文件会自动在 ",[179,548,549],{},"index.json"," 目录中列出，并在 ",[179,552,553],{},"\u002F.well-known\u002Fskills\u002F{skill-name}\u002F"," 下的相应路径提供。",[556,557,558,559,561,562,565],"tip",{},"将主 ",[179,560,205],{}," 保持在 500 行以内。将详细的参考材料移到 ",[179,563,564],{},"references\u002F"," 中的单独文件——Agent 会按需加载，因此较小的文件意味着更少的上下文消耗。",[170,567,53],{"id":53},[175,569,570,571,573,574,577,578,581],{},"默认情况下，TockDocs 在项目根目录的 ",[179,572,181],{}," 目录中查找技能。您可以在 ",[179,575,576],{},"nuxt.config.ts"," 中使用 ",[179,579,580],{},"tockdocs.skills.dir"," 更改此设置：",[235,583,587],{"className":584,"code":585,"filename":576,"language":586,"meta":240,"style":240},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  tockdocs: {\n    skills: {\n      dir: 'agent-skills',\n    },\n  },\n})\n","ts",[179,588,589,608,618,627,646,651,656],{"__ignoreMap":240},[244,590,591,595,598,602,605],{"class":246,"line":247},[244,592,594],{"class":593},"s7zQu","export",[244,596,597],{"class":593}," default",[244,599,601],{"class":600},"s2Zo4"," defineNuxtConfig",[244,603,604],{"class":378},"(",[244,606,607],{"class":313},"{\n",[244,609,610,613,615],{"class":246,"line":254},[244,611,612],{"class":319},"  tockdocs",[244,614,322],{"class":313},[244,616,617],{"class":313}," {\n",[244,619,620,623,625],{"class":246,"line":264},[244,621,622],{"class":319},"    skills",[244,624,322],{"class":313},[244,626,617],{"class":313},[244,628,629,632,634,637,640,643],{"class":246,"line":273},[244,630,631],{"class":319},"      dir",[244,633,322],{"class":313},[244,635,636],{"class":313}," '",[244,638,639],{"class":260},"agent-skills",[244,641,642],{"class":313},"'",[244,644,645],{"class":313},",\n",[244,647,648],{"class":246,"line":108},[244,649,650],{"class":313},"    },\n",[244,652,653],{"class":246,"line":347},[244,654,655],{"class":313},"  },\n",[244,657,658,661],{"class":246,"line":356},[244,659,660],{"class":313},"}",[244,662,663],{"class":378},")\n",[170,665,666],{"id":666},"技能名称要求",[175,668,669,670,675],{},"技能名称必须遵循 ",[188,671,674],{"href":672,"rel":673},"https:\u002F\u002Fagentskills.io\u002Fspecification#name-field",[192],"Agent Skills 命名规范","：",[677,678,679,683,697,700,706],"ul",{},[680,681,682],"li",{},"1-64 个字符",[680,684,685,686,689,690,689,693,696],{},"仅限小写字母、数字和连字符（",[179,687,688],{},"a-z","、",[179,691,692],{},"0-9",[179,694,695],{},"-","）",[680,698,699],{},"不能以连字符开头或结尾",[680,701,702,703,696],{},"不能包含连续连字符（",[179,704,705],{},"--",[680,707,708,709,711],{},"frontmatter 中的 ",[179,710,299],{}," 字段必须与父目录名称匹配",[208,713,714],{},"验证失败的技能将被跳过——请检查构建输出中的警告。",[170,716,717],{"id":717},"多个技能",[175,719,720],{},"您可以从单个文档站点发布多个技能：",[235,722,724],{"className":237,"code":723,"language":239,"meta":240,"style":240},"skills\u002F\n├── my-product\u002F\n│   └── SKILL.md\n├── create-project\u002F\n│   ├── SKILL.md\n│   └── references\u002F\n│       └── templates.md\n└── migration-guide\u002F\n    └── SKILL.md\n",[179,725,726,730,737,746,753,761,770,780,787],{"__ignoreMap":240},[244,727,728],{"class":246,"line":247},[244,729,458],{"class":250},[244,731,732,735],{"class":246,"line":254},[244,733,734],{"class":250},"├──",[244,736,270],{"class":260},[244,738,739,742,744],{"class":246,"line":264},[244,740,741],{"class":250},"│",[244,743,504],{"class":260},[244,745,279],{"class":260},[244,747,748,750],{"class":246,"line":273},[244,749,734],{"class":250},[244,751,752],{"class":260}," create-project\u002F\n",[244,754,755,757,759],{"class":246,"line":108},[244,756,741],{"class":250},[244,758,494],{"class":260},[244,760,279],{"class":260},[244,762,763,765,767],{"class":246,"line":347},[244,764,741],{"class":250},[244,766,504],{"class":260},[244,768,769],{"class":260}," references\u002F\n",[244,771,772,774,777],{"class":246,"line":356},[244,773,741],{"class":250},[244,775,776],{"class":260},"       └──",[244,778,779],{"class":260}," templates.md\n",[244,781,782,784],{"class":246,"line":361},[244,783,257],{"class":250},[244,785,786],{"class":260}," migration-guide\u002F\n",[244,788,789,791],{"class":246,"line":370},[244,790,267],{"class":250},[244,792,279],{"class":260},[175,794,795,796,798],{},"所有技能都会出现在 ",[179,797,549],{}," 目录中，并可以独立安装。",[170,800,801],{"id":801},"预览和版本控制",[175,803,804],{},"由于技能与您的文档一起存储在仓库中，因此它们可以受益于您现有的 Git 工作流：",[677,806,807],{},[680,808,809,813],{},[810,811,812],"strong",{},"分支预览","：在合并之前在预览部署上测试技能更改。在 Vercel 上，每个 Pull Request 都会获得一个预览 URL，您可以在其中验证技能是否正常工作：",[235,815,817],{"className":237,"code":816,"language":239,"meta":240,"style":240},"npx skills add https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[179,818,819],{"__ignoreMap":240},[244,820,821,823,825,827],{"class":246,"line":247},[244,822,427],{"class":250},[244,824,430],{"class":260},[244,826,433],{"class":260},[244,828,829],{"class":260}," https:\u002F\u002Fmy-docs-git-feat-new-skill.vercel.app\n",[677,831,832,838],{},[680,833,834,837],{},[810,835,836],{},"版本控制","：使用 Git 历史跟踪技能更改，在 Pull Request 中审查差异，需要时回滚。",[680,839,840,843],{},[810,841,842],{},"CI\u002FCD","：技能随文档一起自动构建和部署——无需单独的发布步骤。",[556,845,846],{},"使用预览 URL 在发布到生产环境之前使用 AI 工具测试技能。这确保您的技能指令能正确与实际 Agent 配合使用。",[170,848,849],{"id":849},"发现机制",[175,851,852,853,856,857,862,863,866,867,870],{},"此功能实现了 ",[188,854,193],{"href":190,"rel":855},[192],"，该 RFC 扩展了 ",[188,858,861],{"href":859,"rel":860},"https:\u002F\u002Fdatatracker.ietf.org\u002Fdoc\u002Fhtml\u002Frfc8615",[192],"RFC 8615","（与 ACME 证书验证和 ",[179,864,865],{},"security.txt"," 相同的 ",[179,868,869],{},".well-known"," 标准）。",[175,872,873,874,876],{},"TockDocs 在构建时扫描您的 ",[179,875,181],{}," 目录并生成两种类型的端点：",[222,878,879],{"id":879},"发现索引",[235,881,886],{"className":882,"code":884,"language":885},[883],"language-text","GET \u002F.well-known\u002Fskills\u002Findex.json\n","text",[179,887,884],{"__ignoreMap":240},[175,889,890],{},"返回一个 JSON 目录，列出所有可用技能及其描述和文件：",[235,892,896],{"className":893,"code":894,"language":895,"meta":240,"style":240},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"skills\": [\n    {\n      \"name\": \"my-product\",\n      \"description\": \"使用 My Product 构建和部署应用。\",\n      \"files\": [\"SKILL.md\", \"references\u002Fapi.md\"]\n    }\n  ]\n}\n","json",[179,897,898,902,919,924,945,964,997,1002,1007],{"__ignoreMap":240},[244,899,900],{"class":246,"line":247},[244,901,607],{"class":313},[244,903,904,907,911,914,916],{"class":246,"line":254},[244,905,906],{"class":313},"  \"",[244,908,910],{"class":909},"spNyl","skills",[244,912,913],{"class":313},"\"",[244,915,322],{"class":313},[244,917,918],{"class":313}," [\n",[244,920,921],{"class":246,"line":264},[244,922,923],{"class":313},"    {\n",[244,925,926,929,931,933,935,938,941,943],{"class":246,"line":273},[244,927,928],{"class":313},"      \"",[244,930,299],{"class":250},[244,932,913],{"class":313},[244,934,322],{"class":313},[244,936,937],{"class":313}," \"",[244,939,940],{"class":260},"my-product",[244,942,913],{"class":313},[244,944,645],{"class":313},[244,946,947,949,951,953,955,957,960,962],{"class":246,"line":108},[244,948,928],{"class":313},[244,950,295],{"class":250},[244,952,913],{"class":313},[244,954,322],{"class":313},[244,956,937],{"class":313},[244,958,959],{"class":260},"使用 My Product 构建和部署应用。",[244,961,913],{"class":313},[244,963,645],{"class":313},[244,965,966,968,971,973,975,978,980,982,984,987,989,992,994],{"class":246,"line":347},[244,967,928],{"class":313},[244,969,970],{"class":250},"files",[244,972,913],{"class":313},[244,974,322],{"class":313},[244,976,977],{"class":313}," [",[244,979,913],{"class":313},[244,981,205],{"class":260},[244,983,913],{"class":313},[244,985,986],{"class":313},",",[244,988,937],{"class":313},[244,990,991],{"class":260},"references\u002Fapi.md",[244,993,913],{"class":313},[244,995,996],{"class":313},"]\n",[244,998,999],{"class":246,"line":356},[244,1000,1001],{"class":313},"    }\n",[244,1003,1004],{"class":246,"line":361},[244,1005,1006],{"class":313},"  ]\n",[244,1008,1009],{"class":246,"line":370},[244,1010,1011],{"class":313},"}\n",[222,1013,1014],{"id":1014},"技能文件",[235,1016,1019],{"className":1017,"code":1018,"language":885},[883],"GET \u002F.well-known\u002Fskills\u002F{skill-name}\u002FSKILL.md\nGET \u002F.well-known\u002Fskills\u002F{skill-name}\u002Freferences\u002Fapi.md\n",[179,1020,1018],{"__ignoreMap":240},[175,1022,1023,1024,1027,1028,1031,1032,1027,1035,1038],{},"单个技能文件以适当的内容类型提供（",[179,1025,1026],{},".md"," 文件为 ",[179,1029,1030],{},"text\u002Fmarkdown","，",[179,1033,1034],{},".json",[179,1036,1037],{},"application\u002Fjson"," 等）。",[170,1040,1042],{"id":1041},"与-llmstxt-的对比","与 llms.txt 的对比",[175,1044,1045,1048],{},[179,1046,1047],{},"llms.txt"," 和 Agent Skills 都有助于 AI 工具使用您的文档，但它们服务于不同的目的：",[1050,1051,1052,1065],"table",{},[1053,1054,1055],"thead",{},[1056,1057,1058,1061,1063],"tr",{},[1059,1060],"th",{},[1059,1062,1047],{},[1059,1064,201],{},[1066,1067,1068,1082,1095,1108,1121],"tbody",{},[1056,1069,1070,1076,1079],{},[1071,1072,1073],"td",{},[810,1074,1075],{},"目的",[1071,1077,1078],{},"所有文档页面的目录",[1071,1080,1081],{},"功能摘要及可操作指令",[1056,1083,1084,1089,1092],{},[1071,1085,1086],{},[810,1087,1088],{},"内容",[1071,1090,1091],{},"页面标题、描述和链接",[1071,1093,1094],{},"分步工作流、代码示例、约束条件",[1056,1096,1097,1102,1105],{},[1071,1098,1099],{},[810,1100,1101],{},"加载时机",[1071,1103,1104],{},"在发现时",[1071,1106,1107],{},"按需加载，技能被激活时",[1056,1109,1110,1115,1118],{},[1071,1111,1112],{},[810,1113,1114],{},"格式",[1071,1116,1117],{},"带链接的纯文本",[1071,1119,1120],{},"带 YAML frontmatter 的 Markdown",[1056,1122,1123,1128,1131],{},[1071,1124,1125],{},[810,1126,1127],{},"最适合",[1071,1129,1130],{},"帮助 Agent 查找信息",[1071,1132,1133],{},"教导 Agent 如何使用您的产品",[556,1135,1136,1137,1139],{},"二者结合使用：",[179,1138,1047],{}," 告诉 Agent 在哪里查找信息，而技能告诉 Agent 他们可以完成什么以及如何完成。",[1141,1142,1143],"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);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":240,"searchDepth":254,"depth":254,"links":1145},[1146,1147,1153,1154,1155,1156,1157,1158,1162],{"id":172,"depth":254,"text":173},{"id":217,"depth":254,"text":217,"children":1148},[1149,1150,1151,1152],{"id":224,"depth":264,"text":224},{"id":282,"depth":264,"text":283},{"id":405,"depth":264,"text":405},{"id":414,"depth":264,"text":414},{"id":442,"depth":254,"text":442},{"id":53,"depth":254,"text":53},{"id":666,"depth":254,"text":666},{"id":717,"depth":254,"text":717},{"id":801,"depth":254,"text":801},{"id":849,"depth":254,"text":849,"children":1159},[1160,1161],{"id":879,"depth":264,"text":879},{"id":1014,"depth":264,"text":1014},{"id":1041,"depth":254,"text":1042},null,"从您的文档站点发布 Agent 技能，以便 AI 工具自动发现和安装。",{},{"icon":128},{"title":125,"description":1164},"245Rwdlz4S3loTG3YJJxuApBGVQmHGliIO5FILSL_nc",[1170,1172],{"title":120,"path":121,"stem":122,"description":1171,"icon":123,"children":-1},"使用原生 MCP 服务器将您的文档连接到 AI 工具。",{"title":130,"path":131,"stem":132,"description":1173,"icon":133,"children":-1},"TockDocs 使用 Nuxt LLMs 模块生成 AI 就绪的内容文件",1778590913954]