关于 skybridge
skybridge 是用于构建对话式插件的 Agent Skill,插件通过 MCP 服务提供工具和自定义界面。它按需求、架构、实现、测试和部署流程指导开发。
主要功能
- 01使用 SPEC.md 管理需求与设计
- 02架构和实现指导
- 03自定义界面与 LLM 上下文指导
- 04本地测试与模型评估
- 05部署和目录发布指导
适用场景
- 01根据已有 SPEC.md 启动插件
- 02设计供人和 AI 助手协作的界面
- 03实现身份验证或数据获取流程
- 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。
设置
- 复制模板 → copy-template.md:使用已准备好的 SPEC.md 启动新项目时
- 本地运行 → run-locally.md:准备好测试时,需要开发服务器、使用开发者工具渲染视图,或连接 ChatGPT/Claude 时
- 评估 → 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