sleuth-io/sx 源码: https://github.com/sleuth-io/sx ### sx 是您团队的私有 npm，用于管理 AI 资产——包括技能、MCP 配置、命令等。 ### 捕捉您最优秀的 AI 用户的经验，并自动分享给所有人。 星标(https://github.com/sleuth-io/sx/stargazers) 星标历史(https://star-history.com/#sleuth-io/sx&Date) 下载量(https://github.com/sleuth-io/sx/releases) 欢迎PR(https://github.com/sleuth-io/sx/pulls) ⭐ Star 本仓库(https://github.com/sleuth-io/sx) · 🌐 网站(https://skills.new) · 📋 更新日志(https://github.com/sleuth-io/sx/releases) · 📄 许可协议 Demo ## 为什么选择 sx? 您最优秀的开发者已经掌握了如何让 AI 助手变得异常高效——自定义技能、MCP 配置、斜杠命令、经过验证的模式。但这些知识都停留在他们的机器上。 当前的变通方法无法规模化： - 复制到每个仓库 - 重复噩梦，无法集中更新，版本漂移 - 全局配置 - 为不需要这些技能的项目/任务增加上下文负担 - 客户端插件 - 手动安装每个插件，绑定到单一 AI 客户端，无法捆绑 sx 通过以下方式解决： - 分享专业知识 - 将个人发现转化为团队资产 - 即时上手 - 新开发者在第一天就继承团队的 AI 玩法手册 - 集中更新 - 在 vault 中变更一次，所有人都收到更新 - 按范围安装 - 为每个组织、团队、机器人、仓库或人员提供合适的资产，无上下文臃肿 - 兼容任何 AI 客户端 - 支持 Claude Code、Cursor、GitHub Copilot、Gemini、Kiro 等，并通过云中继支持 claude.ai 和 chatgpt.com ## 快速开始 通过 Homebrew 安装（macOS/Linux）: bash brew tap sleuth-io/tap brew install sx 或通过 shell 脚本: bash curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash 然后 bash # 初始化 sx init # 从 vault 添加资产 sx add /path/to/my-skill # 将资产安装到当前项目 sx install 多个 vault？ 使用配置文件切换： bash sx profile add work # 添加新配置文件 sx profile use work # 切换到该配置文件 sx profile list # 查看所有配置文件 安装目标 — 选择谁可以看到哪些资产： bash sx install my-skill --org # vault 中的所有人 sx install my-skill --repo github.com/acme/infra # 仅在该仓库内 sx install my-skill --path github.com/acme/infra#docs/ # 仓库中的某个路径 sx install my-skill --team platform # 团队中的每个成员 sx install my-skill --user [email protected] # 单个用户（必须是调用者） sx install my-skill --bot python-backend # 机器人身份（CI 运行器、代理） | 作用域 | 适用范围 | |—––|———––| | --org | 所有人——未设置标志时的默认值 | | --repo / --path | 在指定仓库或子路径内工作的调用者 | | --team | 团队成员；由管理员控制 | | --user | 单个用户，必须与调用者的 git 身份匹配 | | --bot | 机器人身份，在设置 SX_BOT= 时解析 | 完整概览及各安装目标的范围文档链接，请参见 docs/scoping.md。 预览 — 查看 sx install 会为你解析什么（类似于 pip freeze），不下载也不写入任何内容： bash sx install --dry-run 从 claude.ai 或 chatgpt.com 使用你的 vault — 通过 skills.new 中继将其暴露为 MCP 端点： bash sx cloud connect # 打开 skills.new，粘贴返回的附加行 sx cloud serve # 保持运行 — Ctrl+C 退出 sx cloud status # 打印 MCP URL，粘贴到 claude.ai / chatgpt.com 中继通过你的机器打开的 WebSocket 转发请求——vault 内容保持在本地。详见 docs/cloud-relay.md。 使用分析 & 审计： bash sx stats # 采用率仪表板 sx stats --since 7d --json # 机器可读格式 sx audit # 最近的团队/安装变更 sx audit --actor [email protected] --since 30d --event install.set ### 已经在使用 Claude Code？ 如果你在 .claude 目录中积累了技能、插件或 MCP 配置，sx 能帮助你进行版本管理、跨机器同步以及与队友共享。 bash # 添加现有的技能/命令（sx 自动检测类型） sx add ~/.claude/commands/my-command sx add ~/.claude/skills/my-skill sx add code-review@claude-plugins-official 你的提示文件保持原样——sx 仅用元数据包装它们以实现版本管理。 ## 你可以构建和分享什么？ - 技能 (Skills) - 针对特定任务的自定义提示和行为 - 规则 (Rules) - 应用于特定文件类型或路径的编码标准和指南 - 代理 (Agents) - 具有特定目标的自主 AI 代理 - 命令 (Commands) - 用于快速操作的斜杠命令 - 钩子 (Hooks) - 用于生命周期事件的自动化触发器 - MCP 服务器 (实验性) - 用于外部集成的模型上下文协议 (MCP) 服务器 - 插件 (Plugins) - 包含命令、技能等的 Claude Code 插件包 ## skills.sh 支持 sx 与 skills.sh (https://skills.sh) 集成，后者是一个包含 85,000+ 个代理技能的社区目录。 bash sx add anthropics/skills/frontend-design # 添加特定技能 sx add vercel-labs/agent-skills # 浏览仓库中的技能 sx add --browse # 搜索和浏览整个目录 ## 分发模型 为你的团队选择合适的分发模型： ### 本地（个人） 非常适合在多个个人项目之间轻松共享个人工具 bash sx init --type path --path my/vault/path ### Git vault（小型团队） 通过共享的 git vault 共享资产 bash sx init --type git --repo [email protected]:yourteam/skills.git ### Skills.new（大型团队和企业） 集中管理，提供 UI 用于发现、创建、分享以及使用分析 bash sx init --type sleuth ## 工作原理 sx 遵循 npm、cargo 和 uv 使用的清单-锁文件模式： 1. 清单 (sx.toml) — vault 的真相来源。列出每个管理资产、其安装范围（org、repo、path、team、bot、user）以及团队定义（成员、管理员、仓库）。提交到 git / path vault。详见 docs/manifest-spec.md。 2. 锁文件 — 每个用户解析后的产物。sx install 读取清单，根据调用者的 git 身份解析团队和用户范围，并将结果写入用户的缓存目录 (~/<cache-dir>/sx/lockfiles/)；当解析后的锁发生变化时，前一个文件会加上时间戳轮替，以便旧安装保持可重现。 3. 审计 + 使用流 — 每次团队/安装变更都会将审计条目追加到 .sx/audit/YYYY-MM.jsonl；使用事件追加到 .sx/usage/YYYY-MM.jsonl。通过 sx audit / sx stats 查询。 概括：创建带有元数据的资产，分享到你的 vault，安装 全局、按仓库、按路径、按团队、按机器人或按用户，在新 Claude Code 会话中自动安装，保持同步——每个人都自动获得相同的工具。 ## 支持的客户端 | 客户端 | 状态 | 说明 | |———————––|––––––––|———————————————————–| | Claude Code | ✅ 已支持 | 支持所有资产类型 | | Cline | ✅ 已支持 | 技能、规则、工作流作为命令、MCP 服务器、钩子 | | Codex | ✅ 已支持 | 技能、命令、MCP 服务器 | | Cursor | ✅ 已支持 | 技能、规则、命令、MCP 服务器、钩子 | | GitHub Copilot | ✅ 已支持 | 技能、规则、命令、代理、MCP 服务器、本地钩子 | | Gemini (CLI/VS Code) | ✅ 已支持 | 技能、规则、命令、MCP 服务器、钩子 | | Gemini (JetBrains) | ✅ 已支持 | 仅规则、MCP 服务器（无命令/钩子） | | Gemini (Android Studio) | ✅ 已支持 | 仅规则、MCP-远程（HTTP，无 stdio） | | Kiro | ✅ 已支持 | 技能、规则、命令、MCP 服务器 | | Openclaw | ✅ 已支持 | 技能、规则、命令 | | claude.ai（网页） | ✅ 已支持 | 通过 skills.new 云中继 | | chatgpt.com（网页） | ✅ 已支持 | 通过 skills.new 云中继 | ## 路线图 - ✅ 本地、Git 和 Skills.new vault - ✅ Claude Code 支持 - ✅ Cline 支持 - ✅ Cursor 支持 - ✅ GitHub Copilot 支持 - ✅ Gemini 支持 - ✅ Codex 支持 - ✅ Kiro 支持 - ✅ Openclaw 支持 - ✅ 通过 skills.new 云中继支持 claude.ai 和 chatgpt.com - ✅ 所有 vault 类型的组织、团队、机器人、仓库和个人安装目标 - ✅ 技能发现——使用 Skills.new 从代码和架构中发现相关技能 - ✅ 分析——跟踪技能使用情况和影响 - RBAC 和变更请求流程——支持有门控的技能更新流程 ## 许可协议 详见 LICENSE 文件。 — ## 开发 点击展开开发说明 ### 文档 - Vault 规范 - Vault 目录结构 - 清单规范 - sx.toml 真相来源格式（资产、范围、团队） - 锁文件规范 - 每用户解析的锁文件 - 范围 - 安装目标及按范围文档链接（组织、仓库、团队、用户、机器人） - 审计日志 - 事件目录、sx audit 过滤器、存储格式 - 使用分析 - sx stats 仪表板、JSON 输出、事件格式 - 元数据规范 - 资产元数据格式 - MCP 规范 - MCP 服务器和查询工具 - 配置文件 - 多个配置配置文件 - 客户端 - 客户端支持模型及 IDE 与 CLI 的限制 - 云中继 - 通过 skills.new 将你的 vault 暴露给 claude.ai 和 chatgpt.com ### 前置条件 需要 Go 1.25 或更高版本。使用 gvm (https://github.com/moovweb/gvm) 安装： bash # 安装 gvm bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer) # 安装 Go（如果需要，使用 go1.4 作为引导） gvm install go1.4 -B gvm use go1.4 export GOROOT_BOOTSTRAP=$GOROOT gvm install go1.25 gvm use go1.25 --default ### 从源码构建 bash make init # 首次设置（安装工具、下载依赖） make build # 构建二进制 make install # 安装到 GOPATH/bin ### 测试 bash make test # 运行带竞态检测的测试 make format # 使用 gofmt 格式化代码 make lint # 运行 golangci-lint make prepush # 推送前运行（格式化、lint、测试、构建） ### 发布 打标签并推送以触发 GoReleaser 自动发布： bash git tag v0.1.0 git push origin v0.1.0