mcpField
S
skybridge

skybridge

github.com/alpic-ai开发2.2k1.1k 次安装今天更新
代码仓库

关于 skybridge

skybridge 是用于构建对话式插件的 Agent Skill,插件通过 MCP 服务提供工具和自定义界面。它按需求、架构、实现、测试和部署流程指导开发。

主要功能

  1. 01使用 SPEC.md 管理需求与设计
  2. 02架构和实现指导
  3. 03自定义界面与 LLM 上下文指导
  4. 04本地测试与模型评估
  5. 05部署和目录发布指导

适用场景

  1. 01根据已有 SPEC.md 启动插件
  2. 02设计供人和 AI 助手协作的界面
  3. 03实现身份验证或数据获取流程
  4. 04测试并发布对话式应用

MCP 相关

该 Skill 指导构建作为 MCP 服务运行的对话式应用,向 AI 助手提供工具和自定义界面。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alpic-ai/skybridge --skill skybridge

安装后在 Claude Code 中输入/skybridge确认已加载。

详细介绍

为大模型创建插件

这些对话体验通过工具和自定义 UI 视图扩展 AI 助手。它们以 MCP 服务的形式构建,并在对话过程中调用。

⚠️ 该应用会同时被两类用户使用:人类和 AI 助手大模型。他们通过视图协作——人类与视图交互,大模型则能看到视图的状态。编写代码前,请牢记这一点:视图是你们共享的界面。

SPEC.md 用于跟踪应用的需求和设计决策。开发过程中请及时更新。

没有 SPEC.md? → 请先阅读 discover.md。在 SPEC.md 创建之前,不要做其他事情。

已有 SPEC.md? → 请阅读 SPEC.md,然后按照 architecture.md 设计变更。更新 SPEC.md 后,再阅读下方相关的实现参考文档,然后开始编写代码。

从 Skybridge < 0.36.x 迁移? → 请先阅读 migrate-to-v1.md。用户可能会将 skybridge >= 0.36.x 称为 v1。

从 Skybridge 1.x 迁移到 2.x? → 请先获取 v2.0.0 release notes,并按照其中的说明操作。

正在构建电商应用? → 请先阅读 ecommerce.md。

设置

  1. 复制模板 → copy-template.md:使用已准备好的 SPEC.md 启动新项目时
  2. 本地运行 → run-locally.md:准备好测试时,需要开发服务器、使用开发者工具渲染视图,或连接 ChatGPT/Claude 时
  3. 评估 → evals.md:在测试中检查真实模型是否能根据自然语言提示调用正确的工具时

架构

设计或演进 UX 流程和 API 形态 → architecture.md

实现

  • 获取和渲染数据 → fetch-and-render-data.md:实现服务处理程序和视图数据获取时
  • 状态和上下文 → state-and-context.md:持久化视图 UI 状态并更新大模型上下文时
  • 提示大模型 → prompt-llm.md:视图需要触发大模型响应时
  • UI 指南 → ui-guidelines.md:显示模式、布局限制、主题、设备和区域设置
  • 外部链接 → open-external-links.md:重定向到外部 URL 或设置“在应用中打开”目标时
  • 下载文件 → download-file.md:将内容保存到用户的文件系统时
  • OAuth → oauth.md:工具需要用户身份验证才能访问用户专属数据时
  • CSP → csp.md:声明 fetch、资源、重定向或 iframe 的允许域名时

部署

  • 发布到生产环境 → deploy.md:准备好通过 Alpic 部署时
  • 发布到 ChatGPT/Claude 目录 → publish.md:准备好提交审核时

完整 API 文档:https://docs.skybridge.tech/api-reference.md

发行说明和变更日志:https://skybridge.tech/changelog.md

评论

支持 Markdown