Stream Builder 是 GetStream 的 agent-skills 仓库中的一个技能,定位为框架无关的 Stream 应用构建器,目前正扩展以支持 Web 之外的应用类型。
用途 该技能覆盖三条流程:
- Track A(脚手架):当工作目录为空或新建、用户要求“构建一个……应用”时,从零搭建新应用,执行步骤 0-7。
- Track E(增强):用于增强已有应用,跳过脚手架与主题选择,复用相同的 SDK 接线与组件蓝图。
- Track F(审计):只读审计已有集成,适用于“审计/审查我的视频集成”“对照最佳实践检查我的应用”“我的视频应用是否可上线”“上线前还缺什么”等请求。该流程不搭建、不安装、不运行 CLI,只读取应用并报告发现;仅当用户随后要求修复时才处理问题。
主要能力
- 使用 Shadcn + Next.js 脚手架搭建项目,并添加基础 Shadcn 组件。
- 通过 getstream CLI 完成认证、选择或创建组织与应用、写入项目凭据。
- 按用例安装 Stream SDK:Chat(stream-chat、stream-chat-react)、Video(@stream-io/video-react-sdk)、Feeds(@stream-io/feeds-react-sdk)、Server(@stream-io/node-sdk)。
- 生成代码与 UI,加载 builder-ui.md 及相关产品参考文件与蓝图。
- 验证:先运行 npx tsc --noEmit 做类型检查,再运行 npx next build 完整构建。
- 启动开发服务器,随机选择 5 位端口(10000-65535)。
- 用例匹配:根据用户提到的产品(如 Twitch、Zoom、Slack、WhatsApp、Instagram 等)确定要构建的 Stream 产品组合。
- 支持用例配方(use-case recipes),在 references/use-cases/_use-cases.yaml 中匹配后按配方构建。
- 视频应用需确定 video_primary_use_case 值,作为后端 onboarding/展示元数据,通过 CLI 写入一次。
使用方式 每次会话先读取 ../stream/SKILL.md,若路径为空则用 getstream skills stream 安装;再读取 ../stream/RULES.md。构建流程按顺序执行:步骤 0 使用 npm(不用 bun);步骤 1 运行 getstream init;步骤 2 询问 Shadcn 主题并等待回答;步骤 3 依次执行脚手架、.env、SDK 安装与配置;步骤 4 生成代码与 UI;步骤 5 验证;步骤 6 启动开发服务器;步骤 7 输出总结。
网络与信任 首次网络命令前会向用户打印信任说明,列出将执行的网络调用(npx shadcn、npm install、getstream env 等)及其发布者与写入内容。第三方前端技能包(vercel-react-best-practices、web-design-guidelines、frontend-design)仅在用户明确同意后安装,否则跳过。.env 由 Stream CLI 直接写入,agent 不读取。
适用场景 适用于需要快速搭建或增强基于 Stream 的聊天、视频、Feeds 应用的开发场景,以及上线前对视频集成做只读最佳实践审计。
限制
- 仅使用用户明确提到的产品进行构建,不明确时需询问。
- 审核(Moderation)仅在设置阶段通过 CLI 配置,不在应用内构建审核 UI。
- 脚手架后不修改 layout.tsx 或 globals.css,使用 Shadcn 默认值。
- 开发服务器为长运行进程,后台完成通知不代表服务器停止。
- 部分细节(如具体收费、价格、平台支持范围)暂未提供。