Skybridge 通过 MCP 分发 Agent Skills 完全指南让 AI 执行你的工作流【免费下载链接】skybridgeSkybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-safe. React-powered. Platform-agnostic.项目地址: https://gitcode.com/gh_mirrors/skybr/skybridgeSkybridge 是一个全栈 TypeScript 框架专为 MCP Apps 和 ChatGPT Apps 打造。除了工具Tools和界面Views它现在还支持一个强大的能力通过 MCP 协议分发 Agent Skills智能体技能——把你团队的操作手册SKILL.md 配套文档打包进你的 MCP 服务器让 ChatGPT、Claude 等 AI 助手在需要时按需加载一步步执行你定义的工作流。本指南将带你从零启用、编写、验证到分发 Skills全程只需少量配置。一、Skill 和 Tool 有什么区别先搞清楚核心概念这是写好 Agent Skills 的关键Tool工具Skill技能回答的问题AI能做什么whatAI如何按流程做事how形态一个函数 参数描述一个目录SKILL.md 配套 Markdown 文件加载时机始终在上下文中主机在相关时才拉取可以把 Tool 想象成锤子而 Skill 是一份使用说明书 标准作业流程SOP。比如一个退款流程 Skill 可以告诉 AI先查订单、再核对政策、最后套用邮件模板——这些步骤只在 AI 真正处理退款任务时才进入上下文不占日常对话的 token 预算。二、3 步启用 Skills 分发Skybridge 的接入简单到令人惊讶——放文件、开开关、构建三步搞定第 1 步把技能放进src/skills/目录一个目录 一个技能目录名即技能名src/skills/ refunds/ SKILL.md # 必需YAML 头信息 流程说明 templates/ email.md # 配套文件按需读取第 2 步编写SKILL.md每个SKILL.md以 YAML frontmatter 开头name必须与目录名一致--- name: refunds description: 按公司政策处理客户退款请求。 --- 1. 使用 get-order 查询订单 2. 核对退款政策…第 3 步打开skills开关在项目的server.ts中该选项的 API 说明见 docs/api-reference/skybridge.mdxexport const app new Skybridge({ name: shop, version: 1.0, skills: true, // 启用 Skills 分发 handler, });开启后Skybridge 会声明io.modelcontextprotocol/skills能力并把每个技能发布到skill://名称/SKILL.md这样的标准 URI。完整说明见官方文档 docs/guides/skills.mdx。三、主机Host如何发现和使用技能这是分发背后的协议细节理解它你会更放心列举主机调用skills/list拿到每个技能的 URI、完整 frontmatter、全部文件清单以及逐文件的 SHA-256 摘要——相当于给每个技能文件盖了防伪章。取详情主机调用skills/get获取单个技能。按需加载主机不会主动把技能塞给模型。正确姿势是在工具描述或工具返回结果中引用技能 URI例如写上一句 seeskill://refunds/SKILL.mdAI 判断相关时才拉取完整说明。这些协议的实现代码集中在 packages/core/src/server/skills.ts技能发现逻辑在 discoverSkills 函数skills/list、skills/get两个请求处理器在 registerSkills 函数 中注册URI 解析还内置了路径穿越防护skillUriToRelPath。⚠️ 两点提醒技能只加载Markdown 文件其他格式.json、.py等和符号链接一律忽略避免把目录外文件泄漏出去安全测试见 skills.test.ts。技能是给模型的建议性指令不能绕过模型自身的系统级约束写法上要像写 SOP 而不是下命令。四、向仓库自带的技能学渐进式披露Skybridge 仓库自己就是绝佳范本——它为 AI 编程助手提供了三套技能位于 skills/skybridge/SKILL.md、skills/mcp-app-builder/SKILL.md 和 skills/chatgpt-app-builder/SKILL.md。以官方主技能为例它的主文件只写了决策树 目录索引做电商先看 ecommerce.md迁移先看 migrate-to-v1.md20 篇细则全部放在references/子目录里按需展开。这正是 Agent Skills 的最佳实践主文件保持精简只放路由信息AI 先读它就知道去哪找细节细则拆成独立 Markdown每个主题一个文件按需加载不爆上下文用评估集验证仓库在 skills/chatgpt-app-builder/evals/ 中为每个主题都配了 JSON 评估用例确保用户说自然语言 → AI 找到正确的技能文件五、构建期校验错误在上线前就暴露Skills 分发的质量门槛由 Skybridge 的构建流水线把关启动即校验开发或构建时缺 frontmatter、缺description、name与目录名不匹配都会直接报错中断fails loudly而不是悄悄带病上线自动内联构建步骤 Emitting skills module 会把所有技能及其 SHA-256 摘要内联进产物见 build-steps.ts 与 build-helpers.ts部署后无需运行时再扫描磁盘。你可以用官方自带的开发环境验证效果本地开发服务器提供模拟器与持久隧道可直接把本地应用连到 Claude 或 ChatGPT 中测试技能是否被正确加载。六、注意事项与快速核对清单实验性功能Skills over MCP 跟随 MCP 规范提案 SEP-2640目前仍在评审中接口可能随规范变动且尚不是所有主机都已支持建议先在自己的目标平台上确认来源docs/guides/skills.mdx。上线前核对清单每个技能目录含SKILL.md且 frontmattername与目录名一致description清晰准确——它是 AI 判断何时用这个技能的唯一依据大篇幅细则拆入references/等子目录主文件只留索引只在 Markdown 文件中承载内容避免符号链接在某个工具描述或工具结果中引用了skill://...URI让 AI 能发现它本地 Playground 真实主机双端验证结语把团队的 SOP、运维手册、业务规则写成 Agent Skills再通过 Skybridge 一行skills: true分发到所有支持 MCP 的 AI 助手——这就是让 AI 执行你的工作流的最短路径。建议从 examples/ 中的示例应用起步照着 docs/guides/skills.mdx 跑通第一个技能再参考 skills/skybridge/SKILL.md 的目录组织方式逐步沉淀出你自己的工作流技能库。【免费下载链接】skybridgeSkybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-safe. React-powered. Platform-agnostic.项目地址: https://gitcode.com/gh_mirrors/skybr/skybridge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考