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