[{"data":1,"prerenderedAt":396},["ShallowReactive",2],{"docs-guides\u002Fagent-skill-zh":3},{"id":4,"title":5,"body":6,"description":16,"extension":389,"meta":390,"navigation":391,"path":392,"seo":393,"stem":394,"__hash__":395},"docs\u002Fzh\u002Fguides\u002Fagent-skill.md","Agent Skill 指南",{"type":7,"value":8,"toc":367},"minimark",[9,13,17,22,88,91,101,105,109,127,130,163,166,172,176,179,200,203,223,226,232,236,239,264,267,287,290,297,303,306,333,336,363],[10,11,5],"h1",{"id":12},"agent-skill-指南",[14,15,16],"p",{},"Braid 提供三个可安装的 Agent Skill，分别面向不同使用场景。它们把协议规则、接入步骤、常见错误约束放进 AI 可读取的上下文里，减少临时提示词遗漏和错误实现。",[18,19,21],"h2",{"id":20},"三个-skill","三个 Skill",[23,24,25,41],"table",{},[26,27,28],"thead",{},[29,30,31,35,38],"tr",{},[32,33,34],"th",{},"Skill",[32,36,37],{},"安装目标",[32,39,40],{},"用途",[42,43,44,62,75],"tbody",{},[29,45,46,53,56],{},[47,48,49],"td",{},[50,51,52],"code",{},"braid-manifest",[47,54,55],{},"组件库作者",[47,57,58,59],{},"指导创建和维护 ",[50,60,61],{},"braid.manifest.json",[29,63,64,69,72],{},[47,65,66],{},[50,67,68],{},"braid-setup",[47,70,71],{},"AI Coding 工具（Claude Code、Codex、VS Code 等）",[47,73,74],{},"指导在项目中安装 npm 包、接入前端运行时、配置 manifest",[29,76,77,82,85],{},[47,78,79],{},[50,80,81],{},"braid-protocol",[47,83,84],{},"后端 AI SDK（支持 Skill 机制）",[47,86,87],{},"注入 Braid 协议规则，约束后端 Agent 按规范输出命令流",[14,89,90],{},"三者的关系：",[92,93,98],"pre",{"className":94,"code":96,"language":97},[95],"language-text","┌──────────────────────────────────────┐\n│  braid-manifest（组件库作者）       │\n│  创建和发布 manifest.json             │\n└──────────────┬───────────────────────┘\n               │ manifest 被导入\n               ▼\n┌──────────────────────────────────────┐\n│  braid-setup（开发时）              │\n│  安装 \u002F 接入 \u002F 配置                   │\n└──────────────┬───────────────────────┘\n               │ 接入完成后\n               ▼\n┌──────────────────────────────────────┐\n│  braid-protocol（运行时）           │\n│  驱动后端 Agent 输出正确命令           │\n└──────────────────────────────────────┘\n","text",[50,99,96],{"__ignoreMap":100},"",[18,102,104],{"id":103},"braid-manifest组件库作者技能","braid-manifest（组件库作者技能）",[106,107,108],"h3",{"id":108},"适用场景",[110,111,112,118,121,124],"ul",{},[113,114,115,116],"li",{},"组件库首次接入 Braid，需要创建 ",[50,117,61],{},[113,119,120],{},"向已有库新增组件，需要更新 manifest",[113,122,123],{},"设计组件的 params、events、lifecycle 声明",[113,125,126],{},"校验已有 manifest 是否符合规范",[106,128,129],{"id":129},"安装",[92,131,135],{"className":132,"code":133,"language":134,"meta":100,"style":100},"language-bash shiki shiki-themes one-dark-pro","npx skills add mqhe2007\u002Fbraid --skill braid-manifest\n","bash",[50,136,137],{"__ignoreMap":100},[138,139,142,146,150,153,156,160],"span",{"class":140,"line":141},"line",1,[138,143,145],{"class":144},"sVbv2","npx",[138,147,149],{"class":148},"subq3"," skills",[138,151,152],{"class":148}," add",[138,154,155],{"class":148}," mqhe2007\u002Fbraid",[138,157,159],{"class":158},"sVC51"," --skill",[138,161,162],{"class":148}," braid-manifest\n",[106,164,165],{"id":165},"推荐使用方式",[92,167,170],{"className":168,"code":169,"language":97,"meta":100},[95],"使用 braid-manifest 技能帮我的组件库创建 braid.manifest.json。我的组件包括 PersonalProfileCard 和 ArticleList。\n",[50,171,169],{"__ignoreMap":100},[18,173,175],{"id":174},"braid-setupide-集成技能","braid-setup（IDE 集成技能）",[106,177,108],{"id":178},"适用场景-1",[110,180,181,184,191,197],{},[113,182,183],{},"在已有前端应用中接入 Braid 前端运行时",[113,185,186,187,190],{},"安装 ",[50,188,189],{},"braid"," npm 包并选择框架适配器",[113,192,193,194,196],{},"配置 ",[50,195,61],{}," 并注册前端组件",[113,198,199],{},"排查组件名、manifest 和 registry 不一致的问题",[106,201,129],{"id":202},"安装-1",[92,204,206],{"className":132,"code":205,"language":134,"meta":100,"style":100},"npx skills add mqhe2007\u002Fbraid --skill braid-setup\n",[50,207,208],{"__ignoreMap":100},[138,209,210,212,214,216,218,220],{"class":140,"line":141},[138,211,145],{"class":144},[138,213,149],{"class":148},[138,215,152],{"class":148},[138,217,155],{"class":148},[138,219,159],{"class":158},[138,221,222],{"class":148}," braid-setup\n",[106,224,165],{"id":225},"推荐使用方式-1",[92,227,230],{"className":228,"code":229,"language":97,"meta":100},[95],"使用 braid-setup 技能帮我在 Vue 项目中接入 Braid。安装官方 npm 包，读取组件 manifest，接入前端运行时。\n",[50,231,229],{"__ignoreMap":100},[18,233,235],{"id":234},"braid-protocol协议注入技能","braid-protocol（协议注入技能）",[106,237,108],{"id":238},"适用场景-2",[110,240,241,255,258,261],{},[113,242,243,244,247,248,247,251,254],{},"后端 Agent 需要输出 ",[50,245,246],{},"render","、",[50,249,250],{},"update",[50,252,253],{},"destroy"," 命令流",[113,256,257],{},"通过 AI SDK 的 Skill 机制注入协议约束",[113,259,260],{},"确保命令格式、字段、流式格式符合规范",[113,262,263],{},"避免 Agent 发明不存在的命令类型",[106,265,129],{"id":266},"安装-2",[92,268,270],{"className":132,"code":269,"language":134,"meta":100,"style":100},"npx skills add mqhe2007\u002Fbraid --skill braid-protocol\n",[50,271,272],{"__ignoreMap":100},[138,273,274,276,278,280,282,284],{"class":140,"line":141},[138,275,145],{"class":144},[138,277,149],{"class":148},[138,279,152],{"class":148},[138,281,155],{"class":148},[138,283,159],{"class":158},[138,285,286],{"class":148}," braid-protocol\n",[106,288,165],{"id":289},"推荐使用方式-2",[14,291,292,293,296],{},"让 Skill 机制按需加载该 Skill 的 ",[50,294,295],{},"SKILL.md"," 协议规则。项目最终生效的系统上下文应按三层拼接：",[92,298,301],{"className":299,"code":300,"language":97},[95],"[项目业务提示词 + 工具描述]\n     +\n[braid-protocol 提供并按需加载的协议规则]\n     +\n[项目 manifest + 组件选择规则（项目自行维护）]\n",[50,302,300],{"__ignoreMap":100},[18,304,305],{"id":305},"常见收益",[110,307,308,311,321,324,327,330],{},[113,309,310],{},"避免 Agent 自己实现一套前端运行时",[113,312,313,314,317,318,320],{},"避免把 ",[50,315,316],{},"widgetId"," 放进 ",[50,319,246],{}," 命令",[113,322,323],{},"避免输出协议外的命令类型或非 JSON 数据",[113,325,326],{},"避免组件名、manifest 和 registry 不一致",[113,328,329],{},"让接入步骤更接近官方文档和包导出",[113,331,332],{},"将协议规则与项目 manifest 解耦，各自独立维护",[18,334,335],{"id":335},"相关文档",[110,337,338,345,351,357],{},[113,339,340],{},[341,342,344],"a",{"href":343},"\u002Fdocs\u002Fguides\u002Ffrontend-vue","Vue 前端接入指南",[113,346,347],{},[341,348,350],{"href":349},"\u002Fdocs\u002Fguides\u002Fbackend-nodejs","Node.js 后端接入指南",[113,352,353],{},[341,354,356],{"href":355},"\u002Fdocs\u002Fguides\u002Fcomponent-manifest","组件库 Manifest",[113,358,359],{},[341,360,362],{"href":361},"\u002Fdocs\u002Fprotocol\u002Fcommands","命令协议",[364,365,366],"style",{},"html pre.shiki code .sVbv2, html code.shiki .sVbv2{--shiki-default:#61AFEF}html pre.shiki code .subq3, html code.shiki .subq3{--shiki-default:#98C379}html pre.shiki code .sVC51, html code.shiki .sVC51{--shiki-default:#D19A66}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);}",{"title":100,"searchDepth":368,"depth":368,"links":369},2,[370,371,377,382,387,388],{"id":20,"depth":368,"text":21},{"id":103,"depth":368,"text":104,"children":372},[373,375,376],{"id":108,"depth":374,"text":108},3,{"id":129,"depth":374,"text":129},{"id":165,"depth":374,"text":165},{"id":174,"depth":368,"text":175,"children":378},[379,380,381],{"id":178,"depth":374,"text":108},{"id":202,"depth":374,"text":129},{"id":225,"depth":374,"text":165},{"id":234,"depth":368,"text":235,"children":383},[384,385,386],{"id":238,"depth":374,"text":108},{"id":266,"depth":374,"text":129},{"id":289,"depth":374,"text":165},{"id":305,"depth":368,"text":305},{"id":335,"depth":368,"text":335},"md",{},true,"\u002Fzh\u002Fguides\u002Fagent-skill",{"title":5,"description":16},"zh\u002Fguides\u002Fagent-skill","ryegV523U7P6zScvIFdtFk2Hi69Djt4BAObus0tSVPQ",1786595235824]