Matrix-Sharon

团队技能集市 —— 给团队用的 Claude Code skills / plugins / workflows 共享平台。

这是从 TeamBrain 拆分出来的项目，思想上参考 skills.vote，但更面向团队：

• 明确的 leader / member 角色与权限
• 上传走 leader 审批门，过滤掉 AI 生成的垃圾
• 本地 scanner 自动发现"你刚写完的 skill"，进个人中心"待我决定"
• 一键 Web 安装到本地 ~/.claude/skills/

当前状态

🎉 v1 已完成（Phase 1-6 全数落 main，CI 全绿）。 全部主流程都跑通：登录 → 浏览 → 候选/提交 → leader 审批 → 一键安装 → leader 推送 → 接收侧 dispatcher → 留存率信号回流 leader 视图。

• ✅ 前端原型 —— 全部主流程的可点击 demo（单 HTML 文件，零依赖）
• ✅ 设计文档 —— v1 spec
• ✅ Phase 1 (plan) —— 7 个 package 骨架 + SQLite 10 张表迁移 + CI
• ✅ Phase 2 GitHub OAuth (plan) —— /login/github + /auth/callback + /auth/logout + /v1/me；签名 session cookie；第一个登录用户自动成为 leader
• ✅ Phase 3 浏览 (plan) —— /v1/skills 列表、/v1/skills/:slug 详情、/readme（markdown→html）；Astro 浏览页 + 详情页；sharon-server-seed 灌入样例
• ✅ Phase 4 提交审批 (plan) —— POST /v1/candidates、POST /v1/submissions、leader 队列 + 通过/拒绝；批准自动出不可变 SkillVersion + bundle.tgz；/me/candidates 与 /leader/queue Astro 页面
• ✅ Phase 5 安装 (plan) —— bundle 下载、install-intent token 流；sharon install/uninstall/publish/scan CLI；web 一键安装按钮（sharon:// + 复制命令 fallback）
• ✅ Phase 6 推送 (plan) —— POST /v1/pushes + inbox + ack + done/failed + leader 留存视图；sharon receive 接收侧 dispatcher；/me/inbox 与 /leader/pushes Astro 页面；卸载自动联动 push_receipts 留存信号

开发

完整端到端流程见 SETUP.md。下面是最常用的命令速查。

# 一次性
pnpm install

# 启 server (4321) + web (4322)，一起跑
pnpm dev

# 灌入 3 个样例 skill（第一次想看到内容时）
pnpm seed

# 全部包：类型检查 + 测试
pnpm typecheck
pnpm test

# Sharon CLI（先登录 web 拿到 sharon_session cookie，作为 SHARON_TOKEN）
SHARON_TOKEN=<cookie> pnpm sharon --help
SHARON_TOKEN=<cookie> pnpm sharon install sql-safety-gate
SHARON_TOKEN=<cookie> pnpm sharon uninstall sql-safety-gate
SHARON_TOKEN=<cookie> pnpm sharon publish ./my-skill-dir
SHARON_TOKEN=<cookie> pnpm sharon scan
SHARON_TOKEN=<cookie> pnpm sharon receive   # 跑 leader 推过来的安装

Docker 自托

cp .env.example .env   # 填 SHARON_SESSION_SECRET + GitHub OAuth
docker compose up -d
# server + web 都在 http://127.0.0.1:4321

详见 SETUP.md §5。

OAuth 设置（运行真登录需要）

参考 SETUP.md §2。第一个登录的用户自动成为 leader。

先看原型

🌐 在线 Demo（Vercel 部署）：https://showcase-deploy-pi.vercel.app

• / —— Pitch 页（给 VC / 团队 lead 看的精简密集版）
• /Matrix-Sharon-Showcase.html —— 深度演示页（功能逐节展开）
• /prototype/index.html —— 仓库原型本体（嵌在 showcase 里也能跑）

本地看原型：

# Windows
start prototype/index.html

# macOS / Linux
open prototype/index.html

详见 prototype/README.md。

重新部署 showcase

cd showcase-deploy
vercel --prod      # 需要先 npm i -g vercel && vercel login

showcase-deploy/ 是从 .design-handoff/project/ 同步过来的可部署目录（HTML + JSX + CSS + prototype/）。设计稿迭代时把新 bundle 解压覆盖再 vercel --prod 即可。

团队 git hooks（可选）

.githooks/ 里有 pre-commit 和 post-merge 两个钩子（联动 TeamAgent CLI 的规则同步，未安装 CLI 时只是警告不阻塞）。新成员 clone 后启用：

git config core.hooksPath .githooks

v1 范围（已对齐的决策）

维度	决策
部署形态	单团队自托（公司内部一份）
团队结构	不划队，只有用户 + 角色
角色	leader（Curator + Gatekeeper + Owner 全能）+ member
资源类型 v1	Claude Code 原生 skill（plugin / workflow v1.x 加）
认证	GitHub OAuth
安装路径	Web 一键（底层走本地 sharon CLI/daemon）
提交路径	个人中心"待我决定"候选模式（底层走 sharon publish）
版本模型	每次审批通过自动生不可变版本，latest + pin 都支持
审批	上传 → pending，leader 批准才公开
技术栈	pnpm monorepo · Fastify + SQLite · Astro · 复用 TeamBrain skill-compiler

与 sibling 项目的关系

• Matrix-Riven —— 用户日志上传子系统（TeamBrain 拆分）
• Matrix-Viki —— 个人 AI 规则学习引擎（TeamBrain 拆分）
• Matrix-Plugin-memory —— 插件市场雏形
• Matrix-Sharon（本仓） —— 团队技能集市

License

MIT