sleuth-io/sx

sx 是什么？

sx（发音为 ess-ex）是一个用于在团队中共享 AI "技能"和相关资源的工具——包括自定义提示词、规则、智能体、命令、钩子，甚至微型的模型上下文协议（MCP）服务器。它将一个普通的同步文件夹（Dropbox、Google Drive、OneDrive 等）或 Git 仓库视为一个保险库，将这些资源连同清单（sx.toml）和锁文件一起存储。保险库成为单一事实来源，sx 应用或 sx CLI 可以：

添加资源到保险库（sx add ...）。
为特定范围（组织、仓库、路径、团队、机器人或个人用户）安装它们（sx install ...）。
跟踪谁在使用什么以及消耗了多少令牌（sx stats）。
审计每一次更改（sx audit）。
通过轻量级 WebSocket 中继，将保险库暴露给基于 Web 的 AI 助手（Claude、ChatGPT）（sx cloud ...）。

所有这些都无需专用服务器即可运行——共享文件夹本身就是基础设施，CLI 可以编写脚本或在 CI 管道中运行。

谁会使用它？

角色	优势
非技术团队成员	使用图形界面应用拖放技能并与团队其他成员共享——无需 Git 或终端。
工程师 / DevOps	通过脚本或 CI 自动化发布和安装资源（`sx add`、`sx install`、`sx vault copy`）。
团队负责人 / 经理	获取采用仪表盘（`sx stats`）和不可变的审计跟踪（`sx audit`），以查看哪些技能实际被使用。
AI 工具集成者	为 Claude Code、GitHub Copilot、Cursor、Gemini、Kiro 等生成正确的配置文件，使同一技能在任何地方都能工作。
自主智能体平台的产品负责人	将整个智能体（提示词 + 技能 + 规则 + 钩子）打包一次，并部署到任何受支持的客户端而无需更改。

它是如何工作的？

保险库 – 一个文件夹（本地、同步或 Git），包含：
- sx.toml – 列出每个资源、其版本以及应安装到的范围的清单。
- sx.lock – 清单的每用户解析视图（类似于 package-lock.json）。
- .sx/ – 审计日志、使用日志和生成的插件描述符。
CLI / 应用 – 两者读写相同的配置，因此 GUI 中执行的操作会立即出现在终端中，反之亦然。
范围指定 – 当您运行 sx install <asset> --org 或 --team <name> 时，该工具会将适当的文件写入目标 AI 客户端的配置目录，将通用资源定义转换为特定于客户端的格式。
云中继 – sx cloud serve 运行一个小型进程，通过 WebSocket 将来自基于 Web 的助手（Claude、ChatGPT）的 MCP 请求转发到本地保险库，保持保险库数据私密。
Go 库 – 相同的逻辑以 pkg/sxvault 形式公开，允许其他 Go 程序（例如 hetchy 沙盒运行器）直接读取/写入保险库。

您实际上可以把什么放入保险库？

资源类型	典型内容
技能	提示词模板、系统消息、可选的示例输入。
规则	Lint 风格指南、文件类型限制、自动格式化策略。
智能体	捆绑了提示词及其所需技能/规则的命名机器人定义。
命令	可从客户端 UI 调用的斜杠命令字符串。
钩子	在生命周期事件（例如 Claude 会话开始之前）上运行的脚本。
MCP 服务器	为自定义数据源公开模型上下文协议的小型 HTTP/WebSocket 服务。
插件	从保险库自动生成的打包 Claude Code 或 Codex 插件清单。

如何开始（快速入门）

# 安装 CLI（macOS / Linux）
brew tap sleuth-io/tap && brew install sx
# 或使用一行脚本
curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash

# 在同步文件夹中初始化保险库
sx init --type path --path ~/Dropbox/sx-vault

# 添加技能（在应用中拖放或使用 CLI）
sx add ~/.claude/skills/my-skill

# 为整个团队安装（组织范围）
sx install my-skill --org

# 查看谁在使用它以及令牌消耗
sx stats --since 7d --json

相同的步骤可以从桌面应用执行，该应用会自动捆绑 CLI。

限制 / 未解决的问题

领域	当前状态
RBAC / 变更请求流程	计划中（路线图条目）。
企业级托管	大型团队可以使用托管的 Skills.new 服务；自托管仅限于基于文件夹的模型。
受支持的 AI 客户端	广泛（Claude、Codex、Cursor、GitHub Copilot、Gemini、Kiro 等），但某些客户端仅支持部分资源类型（例如 Gemini JetBrains – 仅限规则）。
跨平台一致性	应用和 CLI 共享单一配置，但捆绑的 CLI 不会自我更新；需要单独安装才能自动更新。

TL;DR

sx 是一个零基础设施、版本控制的保险库系统，用于 AI 相关资源。它允许任何团队（无论技术与否）存储、版本控制、范围指定和审计技能、智能体、规则、命令、钩子和微型 MCP 服务器，并自动将它们安装到所有受支持的 AI 助手中（Claude、Copilot、Cursor、Gemini 等）。该工具可作为跨平台桌面应用和基于 Go 的 CLI 使用，并提供一个 Go 库用于更深入的集成。