[{"data":1,"prerenderedAt":1510},["ShallowReactive",2],{"navigation":3,"\u002Fzh\u002Fhow-to\u002Fskills":129,"\u002Fzh\u002Fhow-to\u002Fskills-surround":1505},[4,68],{"title":5,"path":6,"stem":7,"children":8,"page":22},"En","\u002Fen","en",[9,13,23],{"title":10,"path":11,"stem":12},"Product Overview","\u002Fen\u002Fintroduction","en\u002F0.introduction",{"title":14,"path":15,"stem":16,"children":17,"page":22},"Tutorials","\u002Fen\u002Ftutorials","en\u002F1.tutorials",[18],{"title":19,"path":20,"stem":21},"Quick Start","\u002Fen\u002Ftutorials\u002Fquickstart","en\u002F1.tutorials\u002Fquickstart",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"How To","\u002Fen\u002Fhow-to","en\u002F2.how-to",[28,32,36,40,44,48,52,56,60,64],{"title":29,"path":30,"stem":31},"Canvas Workspace","\u002Fen\u002Fhow-to\u002Fcanvas","en\u002F2.how-to\u002Fcanvas",{"title":33,"path":34,"stem":35},"Configuration","\u002Fen\u002Fhow-to\u002Fconfigure","en\u002F2.how-to\u002Fconfigure",{"title":37,"path":38,"stem":39},"Scheduled Tasks","\u002Fen\u002Fhow-to\u002Fcron-jobs","en\u002F2.how-to\u002Fcron-jobs",{"title":41,"path":42,"stem":43},"Configuring System Service","\u002Fen\u002Fhow-to\u002Finstall","en\u002F2.how-to\u002Finstall",{"title":45,"path":46,"stem":47},"Managing Instructions","\u002Fen\u002Fhow-to\u002Finstructions","en\u002F2.how-to\u002Finstructions",{"title":49,"path":50,"stem":51},"MCP Servers","\u002Fen\u002Fhow-to\u002Fmcp-servers","en\u002F2.how-to\u002Fmcp-servers",{"title":53,"path":54,"stem":55},"Managing Profiles","\u002Fen\u002Fhow-to\u002Fprofiles","en\u002F2.how-to\u002Fprofiles",{"title":57,"path":58,"stem":59},"Configuring Runtimes","\u002Fen\u002Fhow-to\u002Fruntimes","en\u002F2.how-to\u002Fruntimes",{"title":61,"path":62,"stem":63},"Managing Skills","\u002Fen\u002Fhow-to\u002Fskills","en\u002F2.how-to\u002Fskills",{"title":65,"path":66,"stem":67},"VS Code Integration","\u002Fen\u002Fhow-to\u002Fvscode","en\u002F2.how-to\u002Fvscode",{"title":69,"path":70,"stem":71,"children":72,"page":22},"Zh","\u002Fzh","zh",[73,77,85],{"title":74,"path":75,"stem":76},"产品概述","\u002Fzh\u002Fintroduction","zh\u002F0.introduction",{"title":14,"path":78,"stem":79,"children":80,"page":22},"\u002Fzh\u002Ftutorials","zh\u002F1.tutorials",[81],{"title":82,"path":83,"stem":84},"快速开始","\u002Fzh\u002Ftutorials\u002Fquickstart","zh\u002F1.tutorials\u002Fquickstart",{"title":24,"path":86,"stem":87,"children":88,"page":22},"\u002Fzh\u002Fhow-to","zh\u002F2.how-to",[89,93,97,101,105,109,113,117,121,125],{"title":90,"path":91,"stem":92},"Canvas 工作区","\u002Fzh\u002Fhow-to\u002Fcanvas","zh\u002F2.how-to\u002Fcanvas",{"title":94,"path":95,"stem":96},"配置","\u002Fzh\u002Fhow-to\u002Fconfigure","zh\u002F2.how-to\u002Fconfigure",{"title":98,"path":99,"stem":100},"定时任务","\u002Fzh\u002Fhow-to\u002Fcron-jobs","zh\u002F2.how-to\u002Fcron-jobs",{"title":102,"path":103,"stem":104},"配置系统服务","\u002Fzh\u002Fhow-to\u002Finstall","zh\u002F2.how-to\u002Finstall",{"title":106,"path":107,"stem":108},"管理指令文件","\u002Fzh\u002Fhow-to\u002Finstructions","zh\u002F2.how-to\u002Finstructions",{"title":110,"path":111,"stem":112},"MCP 服务器","\u002Fzh\u002Fhow-to\u002Fmcp-servers","zh\u002F2.how-to\u002Fmcp-servers",{"title":114,"path":115,"stem":116},"管理 Profile","\u002Fzh\u002Fhow-to\u002Fprofiles","zh\u002F2.how-to\u002Fprofiles",{"title":118,"path":119,"stem":120},"配置 Runtime","\u002Fzh\u002Fhow-to\u002Fruntimes","zh\u002F2.how-to\u002Fruntimes",{"title":122,"path":123,"stem":124},"管理 Skill","\u002Fzh\u002Fhow-to\u002Fskills","zh\u002F2.how-to\u002Fskills",{"title":126,"path":127,"stem":128},"VS Code 集成","\u002Fzh\u002Fhow-to\u002Fvscode","zh\u002F2.how-to\u002Fvscode",{"id":130,"title":122,"body":131,"description":1499,"extension":1500,"links":1501,"meta":1502,"navigation":280,"path":123,"seo":1503,"stem":124,"__hash__":1504},"docs\u002Fzh\u002F2.how-to\u002Fskills.md",{"type":132,"value":133,"toc":1469},"minimark",[134,138,143,151,173,176,187,190,194,197,208,213,219,360,365,496,505,519,523,526,530,533,537,544,564,567,585,594,598,601,604,607,685,688,691,694,765,769,776,841,845,848,862,865,882,886,889,893,896,963,967,973,979,1009,1012,1018,1063,1066,1089,1093,1096,1104,1131,1134,1138,1141,1150,1173,1176,1180,1252,1255,1270,1274,1288,1291,1294,1298,1303,1362,1366,1369,1430,1436,1439,1465],[135,136,137],"p",{},"一个 Skill 是为 Agent\n编写的能力说明和使用指南。本指南讲述如何安装、管理和在任务中使用 Skill。",[139,140,142],"h2",{"id":141},"什么是-skill","什么是 Skill？",[135,144,145,146,150],{},"Skill 不是工具本身，而是",[147,148,149],"strong",{},"关于工具的文档和最佳实践","。它包含：",[152,153,154,161,167],"ul",{},[155,156,157,160],"li",{},[147,158,159],{},"能力描述","：这个 Skill 能做什么",[155,162,163,166],{},[147,164,165],{},"使用指南","：Agent 何时应该用到它、如何最有效地使用",[155,168,169,172],{},[147,170,171],{},"参考资料","：API 文档、示例代码、常见错误及解决方案",[135,174,175],{},"例如，“Docker 操作” Skill 告诉 Agent 如何：",[152,177,178,181,184],{},[155,179,180],{},"构建镜像、运行容器、查看日志",[155,182,183],{},"处理常见的 Docker 错误",[155,185,186],{},"遵循 Dockerfile 最佳实践",[135,188,189],{},"创建任务时，你选择一个 Profile，Agent 会自动获得该 Profile 关联的所有\nSkill。",[139,191,193],{"id":192},"skill-目录结构","Skill 目录结构",[135,195,196],{},"每个 Skill 是一个目录，具有标准化的结构：",[198,199,204],"pre",{"className":200,"code":202,"language":203},[201],"language-text","skills\u002F\n  docker-ops\u002F              # Skill ID（目录名）\n    SKILL.md               # Skill 元数据 + 内容\n    references\u002F            # 可选的参考资料目录\n      api.md               # 参考文档\n      examples.md\n","text",[205,206,202],"code",{"__ignoreMap":207},"",[209,210,212],"h3",{"id":211},"skillmd-文件格式","SKILL.md 文件格式",[135,214,215,218],{},[205,216,217],{},"SKILL.md"," 包含 YAML frontmatter 和 Markdown 正文：",[198,220,224],{"className":221,"code":222,"language":223,"meta":207,"style":207},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: docker-ops\ndescription: Guide to Docker image, container, and network management\nlicense: MIT\nmetadata:\n  disabled: false\n  contentOverrideMode: replace\n---\n\n## Overview\n\nThis Skill guides agents how to use Docker for common tasks...\n\n## Core concepts\n\n- **Image**: Read-only template containing application and dependencies\n- **Container**: Running instance of an image\n\n## Usage guide\n\n### Build images\n\n...\n","markdown",[205,225,226,234,240,246,252,258,264,270,275,282,288,293,299,304,310,315,321,327,332,338,343,349,354],{"__ignoreMap":207},[227,228,231],"span",{"class":229,"line":230},"line",1,[227,232,233],{},"---\n",[227,235,237],{"class":229,"line":236},2,[227,238,239],{},"name: docker-ops\n",[227,241,243],{"class":229,"line":242},3,[227,244,245],{},"description: Guide to Docker image, container, and network management\n",[227,247,249],{"class":229,"line":248},4,[227,250,251],{},"license: MIT\n",[227,253,255],{"class":229,"line":254},5,[227,256,257],{},"metadata:\n",[227,259,261],{"class":229,"line":260},6,[227,262,263],{},"  disabled: false\n",[227,265,267],{"class":229,"line":266},7,[227,268,269],{},"  contentOverrideMode: replace\n",[227,271,273],{"class":229,"line":272},8,[227,274,233],{},[227,276,278],{"class":229,"line":277},9,[227,279,281],{"emptyLinePlaceholder":280},true,"\n",[227,283,285],{"class":229,"line":284},10,[227,286,287],{},"## Overview\n",[227,289,291],{"class":229,"line":290},11,[227,292,281],{"emptyLinePlaceholder":280},[227,294,296],{"class":229,"line":295},12,[227,297,298],{},"This Skill guides agents how to use Docker for common tasks...\n",[227,300,302],{"class":229,"line":301},13,[227,303,281],{"emptyLinePlaceholder":280},[227,305,307],{"class":229,"line":306},14,[227,308,309],{},"## Core concepts\n",[227,311,313],{"class":229,"line":312},15,[227,314,281],{"emptyLinePlaceholder":280},[227,316,318],{"class":229,"line":317},16,[227,319,320],{},"- **Image**: Read-only template containing application and dependencies\n",[227,322,324],{"class":229,"line":323},17,[227,325,326],{},"- **Container**: Running instance of an image\n",[227,328,330],{"class":229,"line":329},18,[227,331,281],{"emptyLinePlaceholder":280},[227,333,335],{"class":229,"line":334},19,[227,336,337],{},"## Usage guide\n",[227,339,341],{"class":229,"line":340},20,[227,342,281],{"emptyLinePlaceholder":280},[227,344,346],{"class":229,"line":345},21,[227,347,348],{},"### Build images\n",[227,350,352],{"class":229,"line":351},22,[227,353,281],{"emptyLinePlaceholder":280},[227,355,357],{"class":229,"line":356},23,[227,358,359],{},"...\n",[361,362,364],"h4",{"id":363},"frontmatter-字段","Frontmatter 字段",[366,367,368,384],"table",{},[369,370,371],"thead",{},[372,373,374,378,381],"tr",{},[375,376,377],"th",{},"字段",[375,379,380],{},"必填",[375,382,383],{},"说明",[385,386,387,401,414,426,445,469,484],"tbody",{},[372,388,389,395,398],{},[390,391,392],"td",{},[205,393,394],{},"name",[390,396,397],{},"是",[390,399,400],{},"显示名称",[372,402,403,408,411],{},[390,404,405],{},[205,406,407],{},"description",[390,409,410],{},"否",[390,412,413],{},"简短描述",[372,415,416,421,423],{},[390,417,418],{},[205,419,420],{},"license",[390,422,410],{},[390,424,425],{},"许可证",[372,427,428,433,435],{},[390,429,430],{},[205,431,432],{},"metadata.disabled",[390,434,410],{},[390,436,437,438,441,442],{},"禁用此 Skill；值为 ",[205,439,440],{},"false","（默认）或 ",[205,443,444],{},"true",[372,446,447,452,454],{},[390,448,449],{},[205,450,451],{},"metadata.inclusion",[390,453,410],{},[390,455,456,457,460,461,464,465,468],{},"包含策略：",[205,458,459],{},"auto","（默认）— 自动包含，可被更高优先级层覆盖；",[205,462,463],{},"mandatory"," — 强制包含，不可移除；",[205,466,467],{},"explicit"," — 仅在 Profile 中显式引用时生效",[372,470,471,476,478],{},[390,472,473],{},[205,474,475],{},"metadata.overridable",[390,477,410],{},[390,479,480,481,483],{},"高优先级配置层是否可覆盖此资源（默认未设置——允许覆盖）。显式设为 ",[205,482,440],{}," 时，高优先级层的同名条目会被忽略",[372,485,486,491,493],{},[390,487,488],{},[205,489,490],{},"metadata.contentOverrideMode",[390,492,410],{},[390,494,495],{},"多层同 ID Skill 的合并策略，见下文",[135,497,498,504],{},[147,499,500,503],{},[205,501,502],{},"contentOverrideMode"," 说明","：",[152,506,507,513],{},[155,508,509,512],{},[205,510,511],{},"replace","（默认）：使用最高优先级层的内容，忽略低优先级层",[155,514,515,518],{},[205,516,517],{},"merge","：按优先级链式回退（高优先级层中不存在时回退到低优先级层）",[139,520,522],{"id":521},"安装-skill","安装 Skill",[135,524,525],{},"Skill 可以来自三个来源：",[209,527,529],{"id":528},"_1-内置-skill","1. 内置 Skill",[135,531,532],{},"Sink 内置了一些常用 Skill。这些 Skill 无需额外安装即可自动使用。",[209,534,536],{"id":535},"_2-从官方仓库同步","2. 从官方仓库同步",[135,538,539,540,543],{},"从 ",[205,541,542],{},"~\u002F.agents\u002Fskills\u002F"," 目录同步预先下载的 Skill：",[198,545,549],{"className":546,"code":547,"language":548,"meta":207,"style":207},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sink skill sync\n","bash",[205,550,551],{"__ignoreMap":207},[227,552,553,557,561],{"class":229,"line":230},[227,554,556],{"class":555},"sBMFI","sink",[227,558,560],{"class":559},"sfazB"," skill",[227,562,563],{"class":559}," sync\n",[135,565,566],{},"此命令会：",[152,568,569,575],{},[155,570,571,572,574],{},"扫描 ",[205,573,542],{}," 下的所有 Skill 目录",[155,576,577,578,581,582,584],{},"在你的 Sink 配置目录下的 ",[205,579,580],{},"skills\u002F"," 子目录中创建指向\n",[205,583,542],{}," 的符号链接",[135,586,587,590,591,593],{},[147,588,589],{},"前置条件","：你需要事先将 Skill 文件夹下载到 ",[205,592,542],{},"。",[209,595,597],{"id":596},"_3-手动添加-skill","3. 手动添加 Skill",[135,599,600],{},"直接在你的配置目录中创建 Skill 文件夹：",[361,602,603],{"id":603},"用户层安装",[135,605,606],{},"将 Skill 放在用户级配置目录：",[198,608,610],{"className":546,"code":609,"language":548,"meta":207,"style":207},"mkdir -p ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\ncat > ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\u002FSKILL.md \u003C\u003C 'SKILL'\n---\nname: my-custom-skill\ndescription: Custom tutorial\nmetadata:\n  disabled: false\n---\n\n## Overview\nThis is a custom Skill I wrote for agents...\nSKILL\n",[205,611,612,623,641,645,650,655,659,663,667,671,675,680],{"__ignoreMap":207},[227,613,614,617,620],{"class":229,"line":230},[227,615,616],{"class":555},"mkdir",[227,618,619],{"class":559}," -p",[227,621,622],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\n",[227,624,625,628,632,635,638],{"class":229,"line":236},[227,626,627],{"class":555},"cat",[227,629,631],{"class":630},"sMK4o"," >",[227,633,634],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-custom-skill\u002FSKILL.md",[227,636,637],{"class":630}," \u003C\u003C",[227,639,640],{"class":630}," 'SKILL'\n",[227,642,643],{"class":229,"line":242},[227,644,233],{"class":559},[227,646,647],{"class":229,"line":248},[227,648,649],{"class":559},"name: my-custom-skill\n",[227,651,652],{"class":229,"line":254},[227,653,654],{"class":559},"description: Custom tutorial\n",[227,656,657],{"class":229,"line":260},[227,658,257],{"class":559},[227,660,661],{"class":229,"line":266},[227,662,263],{"class":559},[227,664,665],{"class":229,"line":272},[227,666,233],{"class":559},[227,668,669],{"class":229,"line":277},[227,670,281],{"emptyLinePlaceholder":280},[227,672,673],{"class":229,"line":284},[227,674,287],{"class":559},[227,676,677],{"class":229,"line":290},[227,678,679],{"class":559},"This is a custom Skill I wrote for agents...\n",[227,681,682],{"class":229,"line":295},[227,683,684],{"class":630},"SKILL\n",[135,686,687],{},"该 Skill 将对所有工作区可用。",[361,689,690],{"id":690},"工作区层安装",[135,692,693],{},"将 Skill 放在工作区配置目录，仅对该工作区生效：",[198,695,697],{"className":546,"code":696,"language":548,"meta":207,"style":207},"mkdir -p \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\ncat > \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\u002FSKILL.md \u003C\u003C 'SKILL'\n---\nname: project-specific-skill\ndescription: Available only in this project\nmetadata:\n  disabled: false\n---\n\n## Project background\nDescribe project-specific practices and conventions in this Skill...\nSKILL\n",[205,698,699,708,721,725,730,735,739,743,747,751,756,761],{"__ignoreMap":207},[227,700,701,703,705],{"class":229,"line":230},[227,702,616],{"class":555},[227,704,619],{"class":559},[227,706,707],{"class":559}," \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\n",[227,709,710,712,714,717,719],{"class":229,"line":236},[227,711,627],{"class":555},[227,713,631],{"class":630},[227,715,716],{"class":559}," \u002Fpath\u002Fto\u002Fmy-project\u002Fsink\u002Fskills\u002Fproject-specific-skill\u002FSKILL.md",[227,718,637],{"class":630},[227,720,640],{"class":630},[227,722,723],{"class":229,"line":242},[227,724,233],{"class":559},[227,726,727],{"class":229,"line":248},[227,728,729],{"class":559},"name: project-specific-skill\n",[227,731,732],{"class":229,"line":254},[227,733,734],{"class":559},"description: Available only in this project\n",[227,736,737],{"class":229,"line":260},[227,738,257],{"class":559},[227,740,741],{"class":229,"line":266},[227,742,263],{"class":559},[227,744,745],{"class":229,"line":272},[227,746,233],{"class":559},[227,748,749],{"class":229,"line":277},[227,750,281],{"emptyLinePlaceholder":280},[227,752,753],{"class":229,"line":284},[227,754,755],{"class":559},"## Project background\n",[227,757,758],{"class":229,"line":290},[227,759,760],{"class":559},"Describe project-specific practices and conventions in this Skill...\n",[227,762,763],{"class":229,"line":295},[227,764,684],{"class":630},[209,766,768],{"id":767},"_4-添加参考资料","4. 添加参考资料",[135,770,771,772,775],{},"在 Skill 目录中创建 ",[205,773,774],{},"references\u002F"," 子目录来存放附加文档：",[198,777,779],{"className":546,"code":778,"language":548,"meta":207,"style":207},"mkdir -p ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\ncat > ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\u002Fapi.md \u003C\u003C 'REF'\n# Docker API Reference\n\n## Common commands\n\n- `docker build` - Build image\n- `docker run` - Run container\n...\nREF\n",[205,780,781,790,804,809,813,818,822,827,832,836],{"__ignoreMap":207},[227,782,783,785,787],{"class":229,"line":230},[227,784,616],{"class":555},[227,786,619],{"class":559},[227,788,789],{"class":559}," ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\n",[227,791,792,794,796,799,801],{"class":229,"line":236},[227,793,627],{"class":555},[227,795,631],{"class":630},[227,797,798],{"class":559}," ~\u002F.sink\u002Fskills\u002Fdocker-ops\u002Freferences\u002Fapi.md",[227,800,637],{"class":630},[227,802,803],{"class":630}," 'REF'\n",[227,805,806],{"class":229,"line":242},[227,807,808],{"class":559},"# Docker API Reference\n",[227,810,811],{"class":229,"line":248},[227,812,281],{"emptyLinePlaceholder":280},[227,814,815],{"class":229,"line":254},[227,816,817],{"class":559},"## Common commands\n",[227,819,820],{"class":229,"line":260},[227,821,281],{"emptyLinePlaceholder":280},[227,823,824],{"class":229,"line":266},[227,825,826],{"class":559},"- `docker build` - Build image\n",[227,828,829],{"class":229,"line":272},[227,830,831],{"class":559},"- `docker run` - Run container\n",[227,833,834],{"class":229,"line":277},[227,835,359],{"class":559},[227,837,838],{"class":229,"line":284},[227,839,840],{"class":630},"REF\n",[139,842,844],{"id":843},"查看已安装的-skill","查看已安装的 Skill",[135,846,847],{},"列出当前可用的所有 Skill：",[198,849,851],{"className":546,"code":850,"language":548,"meta":207,"style":207},"sink skill list\n",[205,852,853],{"__ignoreMap":207},[227,854,855,857,859],{"class":229,"line":230},[227,856,556],{"class":555},[227,858,560],{"class":559},[227,860,861],{"class":559}," list\n",[135,863,864],{},"输出将显示：",[152,866,867,870,873,876,879],{},[155,868,869],{},"Skill ID（目录名）",[155,871,872],{},"显示名称（来自 frontmatter）",[155,874,875],{},"描述",[155,877,878],{},"来源（builtin \u002F user \u002F workspace）",[155,880,881],{},"启用状态",[139,883,885],{"id":884},"在-profile-中关联-skill","在 Profile 中关联 Skill",[135,887,888],{},"Skill 通过 Profile 关联到 Agent。一旦创建任务，Agent 会自动获得该\nProfile 关联的所有 Skill。",[209,890,892],{"id":891},"编辑-profile","编辑 Profile",[135,894,895],{},"打开 Profile 文件（Markdown 格式）并在 frontmatter 中指定 Skill：",[198,897,899],{"className":221,"code":898,"language":223,"meta":207,"style":207},"---\nname: code-reviewer\ndescription: Code quality analysis and review\nruntime: claude-code\nskills:\n  - web-search\n  - code-analysis\n  - test-runner\nmcpServers:\n  - filesystem\n---\n\nYou are an experienced code reviewer specializing in software quality...\n",[205,900,901,905,910,915,920,925,930,935,940,945,950,954,958],{"__ignoreMap":207},[227,902,903],{"class":229,"line":230},[227,904,233],{},[227,906,907],{"class":229,"line":236},[227,908,909],{},"name: code-reviewer\n",[227,911,912],{"class":229,"line":242},[227,913,914],{},"description: Code quality analysis and review\n",[227,916,917],{"class":229,"line":248},[227,918,919],{},"runtime: claude-code\n",[227,921,922],{"class":229,"line":254},[227,923,924],{},"skills:\n",[227,926,927],{"class":229,"line":260},[227,928,929],{},"  - web-search\n",[227,931,932],{"class":229,"line":266},[227,933,934],{},"  - code-analysis\n",[227,936,937],{"class":229,"line":272},[227,938,939],{},"  - test-runner\n",[227,941,942],{"class":229,"line":277},[227,943,944],{},"mcpServers:\n",[227,946,947],{"class":229,"line":284},[227,948,949],{},"  - filesystem\n",[227,951,952],{"class":229,"line":290},[227,953,233],{},[227,955,956],{"class":229,"line":295},[227,957,281],{"emptyLinePlaceholder":280},[227,959,960],{"class":229,"line":301},[227,961,962],{},"You are an experienced code reviewer specializing in software quality...\n",[361,964,966],{"id":965},"skills-字段","Skills 字段",[135,968,969,972],{},[205,970,971],{},"skills"," 字段支持两种写法：",[135,974,975,978],{},[147,976,977],{},"简单列表","（白名单）：",[198,980,984],{"className":981,"code":982,"language":983,"meta":207,"style":207},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","skills:\n  - web-search\n  - docker-ops\n","yaml",[205,985,986,994,1002],{"__ignoreMap":207},[227,987,988,991],{"class":229,"line":230},[227,989,971],{"class":990},"swJcz",[227,992,993],{"class":630},":\n",[227,995,996,999],{"class":229,"line":236},[227,997,998],{"class":630},"  -",[227,1000,1001],{"class":559}," web-search\n",[227,1003,1004,1006],{"class":229,"line":242},[227,1005,998],{"class":630},[227,1007,1008],{"class":559}," docker-ops\n",[135,1010,1011],{},"只有列表中的 Skill 可用。",[135,1013,1014,1017],{},[147,1015,1016],{},"选择器写法","（include\u002Fexclude）：",[198,1019,1021],{"className":981,"code":1020,"language":983,"meta":207,"style":207},"skills:\n  include:\n    - web-search\n    - docker-ops\n  exclude:\n    - experimental-skill\n",[205,1022,1023,1029,1036,1043,1049,1056],{"__ignoreMap":207},[227,1024,1025,1027],{"class":229,"line":230},[227,1026,971],{"class":990},[227,1028,993],{"class":630},[227,1030,1031,1034],{"class":229,"line":236},[227,1032,1033],{"class":990},"  include",[227,1035,993],{"class":630},[227,1037,1038,1041],{"class":229,"line":242},[227,1039,1040],{"class":630},"    -",[227,1042,1001],{"class":559},[227,1044,1045,1047],{"class":229,"line":248},[227,1046,1040],{"class":630},[227,1048,1008],{"class":559},[227,1050,1051,1054],{"class":229,"line":254},[227,1052,1053],{"class":990},"  exclude",[227,1055,993],{"class":630},[227,1057,1058,1060],{"class":229,"line":260},[227,1059,1040],{"class":630},[227,1061,1062],{"class":559}," experimental-skill\n",[135,1064,1065],{},"或仅排除：",[198,1067,1069],{"className":981,"code":1068,"language":983,"meta":207,"style":207},"skills:\n  exclude:\n    - experimental-skill\n",[205,1070,1071,1077,1083],{"__ignoreMap":207},[227,1072,1073,1075],{"class":229,"line":230},[227,1074,971],{"class":990},[227,1076,993],{"class":630},[227,1078,1079,1081],{"class":229,"line":236},[227,1080,1053],{"class":990},[227,1082,993],{"class":630},[227,1084,1085,1087],{"class":229,"line":242},[227,1086,1040],{"class":630},[227,1088,1062],{"class":559},[139,1090,1092],{"id":1091},"禁用-skill","禁用 Skill",[209,1094,1095],{"id":1095},"临时禁用",[135,1097,1098,1099,1101,1102,504],{},"修改 Skill 的 frontmatter，将 ",[205,1100,432],{}," 设为 ",[205,1103,444],{},[198,1105,1107],{"className":221,"code":1106,"language":223,"meta":207,"style":207},"---\nname: web-search\nmetadata:\n  disabled: true\n---\n",[205,1108,1109,1113,1118,1122,1127],{"__ignoreMap":207},[227,1110,1111],{"class":229,"line":230},[227,1112,233],{},[227,1114,1115],{"class":229,"line":236},[227,1116,1117],{},"name: web-search\n",[227,1119,1120],{"class":229,"line":242},[227,1121,257],{},[227,1123,1124],{"class":229,"line":248},[227,1125,1126],{},"  disabled: true\n",[227,1128,1129],{"class":229,"line":254},[227,1130,233],{},[135,1132,1133],{},"禁用后，该 Skill 将从所有 Profile 的可用 Skill 列表中移除。",[209,1135,1137],{"id":1136},"从特定-profile-中排除","从特定 Profile 中排除",[135,1139,1140],{},"如果不想全局禁用，而只想从某些 Profile 中排除：",[135,1142,1143,1144,1146,1147,504],{},"在 Profile 的 ",[205,1145,971],{}," 字段中使用 ",[205,1148,1149],{},"exclude",[198,1151,1153],{"className":981,"code":1152,"language":983,"meta":207,"style":207},"skills:\n  exclude:\n    - web-search\n",[205,1154,1155,1161,1167],{"__ignoreMap":207},[227,1156,1157,1159],{"class":229,"line":230},[227,1158,971],{"class":990},[227,1160,993],{"class":630},[227,1162,1163,1165],{"class":229,"line":236},[227,1164,1053],{"class":990},[227,1166,993],{"class":630},[227,1168,1169,1171],{"class":229,"line":242},[227,1170,1040],{"class":630},[227,1172,1001],{"class":559},[139,1174,1175],{"id":1175},"最佳实践",[209,1177,1179],{"id":1178},"编写清晰的-skill","编写清晰的 Skill",[1181,1182,1183,1204,1243],"ol",{},[155,1184,1185,1188,1189],{},[147,1186,1187],{},"标题明确","：Skill 名称应直观反映其用途",[198,1190,1192],{"className":981,"code":1191,"language":983,"meta":207,"style":207},"name: error-fixing-and-debugging\n",[205,1193,1194],{"__ignoreMap":207},[227,1195,1196,1198,1201],{"class":229,"line":230},[227,1197,394],{"class":990},[227,1199,1200],{"class":630},":",[227,1202,1203],{"class":559}," error-fixing-and-debugging\n",[155,1205,1206,1209,1210],{},[147,1207,1208],{},"包含具体示例","：好的 Skill 包含代码示例和常见错误",[198,1211,1213],{"className":221,"code":1212,"language":223,"meta":207,"style":207},"## Common errors\n\n### Error: Connection refused\n\n**Cause**: Service not started\n**Solution**: Run `docker run -d my-service`\n",[205,1214,1215,1220,1224,1229,1233,1238],{"__ignoreMap":207},[227,1216,1217],{"class":229,"line":230},[227,1218,1219],{},"## Common errors\n",[227,1221,1222],{"class":229,"line":236},[227,1223,281],{"emptyLinePlaceholder":280},[227,1225,1226],{"class":229,"line":242},[227,1227,1228],{},"### Error: Connection refused\n",[227,1230,1231],{"class":229,"line":248},[227,1232,281],{"emptyLinePlaceholder":280},[227,1234,1235],{"class":229,"line":254},[227,1236,1237],{},"**Cause**: Service not started\n",[227,1239,1240],{"class":229,"line":260},[227,1241,1242],{},"**Solution**: Run `docker run -d my-service`\n",[155,1244,1245,1248,1249,1251],{},[147,1246,1247],{},"组织参考资料","：复杂的 Skill 应在 ",[205,1250,774],{}," 目录中分类存放文档",[209,1253,1254],{"id":1254},"共享与版本管理",[1181,1256,1257,1260,1267],{},[155,1258,1259],{},"将 Skill 存储在版本控制中（Git）",[155,1261,1262,1263,1266],{},"使用语义化版本（如 ",[205,1264,1265],{},"v1.0.0","）标记发行版",[155,1268,1269],{},"在 Profile 中显式记录依赖的 Skill 版本（如需要）",[209,1271,1273],{"id":1272},"skill-与-mcp-server-的区别","Skill 与 MCP Server 的区别",[152,1275,1276,1282],{},[155,1277,1278,1281],{},[147,1279,1280],{},"Skill"," = 指南和最佳实践文档",[155,1283,1284,1287],{},[147,1285,1286],{},"MCP Server"," = 实际的工具和能力实现",[135,1289,1290],{},"Agent 依赖 MCP Server 执行操作，依赖 Skill\n理解”何时使用”和”如何用好”。两者互补。",[139,1292,1293],{"id":1293},"故障排除",[209,1295,1297],{"id":1296},"skill-未显示在-profile-中","Skill 未显示在 Profile 中",[135,1299,1300,504],{},[147,1301,1302],{},"检查清单",[1181,1304,1305,1318,1338],{},[155,1306,1307,1308],{},"Skill 是否被禁用？",[198,1309,1311],{"className":546,"code":1310,"language":548,"meta":207,"style":207},"# 检查 SKILL.md 中的 metadata.disabled\n",[205,1312,1313],{"__ignoreMap":207},[227,1314,1315],{"class":229,"line":230},[227,1316,1310],{"class":1317},"sHwdD",[155,1319,1320,1321],{},"Skill ID 是否正确？",[198,1322,1324],{"className":546,"code":1323,"language":548,"meta":207,"style":207},"sink skill list  # 查看实际 Skill ID\n",[205,1325,1326],{"__ignoreMap":207},[227,1327,1328,1330,1332,1335],{"class":229,"line":230},[227,1329,556],{"class":555},[227,1331,560],{"class":559},[227,1333,1334],{"class":559}," list",[227,1336,1337],{"class":1317},"  # 查看实际 Skill ID\n",[155,1339,1340,1341],{},"Profile 中的 Skill 引用是否拼写正确？",[198,1342,1344],{"className":981,"code":1343,"language":983,"meta":207,"style":207},"skills:\n  - correct-skill-id # 必须与 skill list 输出一致\n",[205,1345,1346,1352],{"__ignoreMap":207},[227,1347,1348,1350],{"class":229,"line":230},[227,1349,971],{"class":990},[227,1351,993],{"class":630},[227,1353,1354,1356,1359],{"class":229,"line":236},[227,1355,998],{"class":630},[227,1357,1358],{"class":559}," correct-skill-id",[227,1360,1361],{"class":1317}," # 必须与 skill list 输出一致\n",[209,1363,1365],{"id":1364},"多层-skill-冲突","多层 Skill 冲突",[135,1367,1368],{},"如果你在用户层和工作区层都定义了同 ID 的\nSkill，并且看到了意外的内容，检查：",[198,1370,1372],{"className":546,"code":1371,"language":548,"meta":207,"style":207},"# 查看有效配置（已合并）\ncat \u003Cworkspace>\u002F.sink\u002F.settings.snapshot.json\n\n# 查看原始文件\ncat ~\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\ncat \u003Cworkspace>\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[205,1373,1374,1379,1399,1403,1408,1415],{"__ignoreMap":207},[227,1375,1376],{"class":229,"line":230},[227,1377,1378],{"class":1317},"# 查看有效配置（已合并）\n",[227,1380,1381,1383,1386,1389,1393,1396],{"class":229,"line":236},[227,1382,627],{"class":555},[227,1384,1385],{"class":630}," \u003C",[227,1387,1388],{"class":559},"workspac",[227,1390,1392],{"class":1391},"sTEyZ","e",[227,1394,1395],{"class":630},">",[227,1397,1398],{"class":559},"\u002F.sink\u002F.settings.snapshot.json\n",[227,1400,1401],{"class":229,"line":242},[227,1402,281],{"emptyLinePlaceholder":280},[227,1404,1405],{"class":229,"line":248},[227,1406,1407],{"class":1317},"# 查看原始文件\n",[227,1409,1410,1412],{"class":229,"line":254},[227,1411,627],{"class":555},[227,1413,1414],{"class":559}," ~\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[227,1416,1417,1419,1421,1423,1425,1427],{"class":229,"line":260},[227,1418,627],{"class":555},[227,1420,1385],{"class":630},[227,1422,1388],{"class":559},[227,1424,1392],{"class":1391},[227,1426,1395],{"class":630},[227,1428,1429],{"class":559},"\u002F.sink\u002Fskills\u002Fmy-skill\u002FSKILL.md\n",[135,1431,1432,1433,593],{},"优先级是",[147,1434,1435],{},"工作区 > 用户 > 内置",[139,1437,1438],{"id":1438},"下一步",[152,1440,1441,1449,1457],{},[155,1442,1443,1444,1448],{},"了解如何 ",[1445,1446,114],"a",{"href":1447},".\u002Fprofiles","，将 Skill 关联到 Agent",[155,1450,1451,1452,1456],{},"查看 ",[1445,1453,1455],{"href":1454},".\u002Fmcp-servers","配置 MCP Server","，为 Agent 添加实际工具",[155,1458,1459,1460,1464],{},"创建第一个 ",[1445,1461,1463],{"href":1462},"..\u002Ftutorials\u002Fquickstart","任务","，让 Agent 使用你配置的\nSkill",[1466,1467,1468],"style",{},"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 .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 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 .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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":207,"searchDepth":230,"depth":236,"links":1470},[1471,1472,1475,1481,1482,1485,1489,1494,1498],{"id":141,"depth":236,"text":142},{"id":192,"depth":236,"text":193,"children":1473},[1474],{"id":211,"depth":242,"text":212},{"id":521,"depth":236,"text":522,"children":1476},[1477,1478,1479,1480],{"id":528,"depth":242,"text":529},{"id":535,"depth":242,"text":536},{"id":596,"depth":242,"text":597},{"id":767,"depth":242,"text":768},{"id":843,"depth":236,"text":844},{"id":884,"depth":236,"text":885,"children":1483},[1484],{"id":891,"depth":242,"text":892},{"id":1091,"depth":236,"text":1092,"children":1486},[1487,1488],{"id":1095,"depth":242,"text":1095},{"id":1136,"depth":242,"text":1137},{"id":1175,"depth":236,"text":1175,"children":1490},[1491,1492,1493],{"id":1178,"depth":242,"text":1179},{"id":1254,"depth":242,"text":1254},{"id":1272,"depth":242,"text":1273},{"id":1293,"depth":236,"text":1293,"children":1495},[1496,1497],{"id":1296,"depth":242,"text":1297},{"id":1364,"depth":242,"text":1365},{"id":1438,"depth":236,"text":1438},"学习如何安装、配置和在 Profile 中使用 Agent Skill","md",null,{},{"title":122,"description":1499},"lrdz3Hf0wmD3m_N5ANZBlSvxToKbD4C8wfvrEEdaXNA",[1506,1508],{"title":118,"path":119,"stem":120,"description":1507,"children":-1},"如何注册和管理 ACP Agent Runtime",{"title":126,"path":127,"stem":128,"description":1509,"children":-1},"使用内置 VS Code 进行 Workspace 开发",1778225994052]