Floom

通过链接分享 AI 智能体技能。

Floom 技能是指你分享的任何能让智能体更好地完成工作的资源：品牌语调知识、公司事实、入职文档、销售工作流、编码规范，以及后续的可执行技能。

npm install -g @floomhq/floom
floom login
floom publish pr-review-brief.md
# -> https://floom.dev/s/ffas93ud

floom add https://floom.dev/s/ffas93ud
# -> adds pr-review-brief.md locally

从终端发布知识、指令和工作流。任何人都可以添加并在他们的智能体中使用它们。

Floom 版本 0 - 分享功能有意保持精简：终端发布、链接分享、本地添加。Markdown 是源接口。没有仪表板，没有市场，没有托管执行。

Floom 版本 1 - 同步功能从预览开始：floom sync、floom watch、支持文件夹的本地写入，以及针对你已发布技能的 MCP 启动/轮询同步。完整的版本 1 稍后可以推广热重载、更新传播、依赖管理、安装跟踪、语义版本控制和回滚。

Floom 版本 2 是团队功能和第一个可供公司测试的闭环：创建者 UI、接收者 UI、技能标签、电子邮件邀请和交付、安装/更新跟踪以及清晰的 MCP 入门引导。

结构

• cli/ — Node 22 TypeScript CLI，发布为 @floomhq/floom

• mcp-sync/ — MCP 服务器预览，发布为 @floomhq/floom-mcp-sync

• web/ — Next.js 16 应用（落地页 + API 路由），部署到 Vercel

• supabase/ — 现有 skills_minimal 模式的 SQL 迁移

Related MCP server: IteraTools MCP

后续版本原型代码

该仓库仍包含后续版本的原型代码。这些路由在版本明确推广它们之前处于休眠状态。

版本 0 端点

• POST /api/skills (需要认证) — 请求体 { title?, description?, body_md, visibility?, asset_type?, source?, installs_as?, version? }

• DELETE /api/v1/skills/:slug (需要认证) — 创建者软删除

• GET /s/:slug.md — 公开的原始 Markdown

• GET /s/:slug.json — 公开的完整记录

• GET /api/me — 当前用户 (需要认证)

模式

现有 Supabase 项目中的 skills_minimal.posts。Slug 是短 nanoid（8 个字符）。RLS 禁止匿名直接读取；公共端点使用服务角色进行获取。

V0 保留了外部名词 skill，同时在底层存储通用元数据：asset_type (knowledge, instruction, workflow, skill)、source (markdown) 和 installs_as (claude_skill, memory, rule, codex_instruction 等)。V0 还存储来自 frontmatter 或 CLI 标志的可选 version 标签。版本历史、回滚和更新传播是后续版本的功能。

部署

# Backend (web/)
cd web && vercel --prod

# CLI publish
cd cli && npm publish --access public

版本 0 范围

范围内：

• floom publish <file>

• 来自 frontmatter 或 floom publish --version 的可选版本标签

• 可共享的技能链接

• floom add <url-or-slug>

• floom info <url-or-slug>

• floom delete <url-or-slug>

• 原始 Markdown 技能端点

• 最小化认证

范围外：

• 团队仪表板

• 市场发现

• 文件夹和标签

• 审批

• 托管执行

• 浏览器扩展

版本 1 预览范围

范围内：

• floom sync

• floom watch

• MCP 启动和轮询同步预览

• 仅针对你已发布技能的缺失文件写入

• 本地冲突保护

• 基于服务器元数据的文件夹感知写入

范围外：

• 创建者和接收者仪表板

• 电子邮件分享和交付

• 团队库

• 版本历史和回滚

• 自动本地 Markdown 删除

• 托管执行

完整的版本 1 后续：

• 在支持的情况下通过 MCP 进行热重载

• 更新传播

• 依赖管理

• 安装跟踪

• 语义版本控制

• 回滚