AIGC: ContentProducer: Minimax Agent AI ContentPropagator: Minimax Agent AI Label: AIGC ProduceID: "00000000000000000000000000000000" PropagateID: "00000000000000000000000000000000" ReservedCode1: 3046022100e44f786f7f96a86753e56a5a2113ff46ad097daa5422e623785cacf7d220a078022100bfdcbe2dd2f24aa0a56d2c66a9ccb2e6d7d13cfc459749a86af9e64c0b045424 ReservedCode2: 304502203178b3ac6b58a10ed57f5c21d765b5b031b9d61de4963cd2b4e2c50098c4b476022100ccb85ae5dcd2b557ad5dc8d43f2b946dc8b30f9de29558cb9420c25f47417ecd

Cursor Team Skill Manager

一个功能强大的 Cursor IDE 插件，用于管理团队 Skill 配置。它允许团队成员集中管理、分享和自动部署预定义的 Skill 配置，从而提升团队协作效率和代码一致性。

功能特性

核心功能

功能	描述
团队 Skill 源管理	配置多个团队 Skill 源，支持添加、编辑、删除和测试连接
自动下载安装	一键安装团队共享的 Skill，自动处理依赖关系
智能更新同步	检测并自动更新已安装的 Skill，支持批量同步
本地缓存管理	高效的本地缓存机制，支持离线访问已安装的 Skill
灵活的认证机制	支持无认证、用户名密码、API Key 等多种认证方式

用户界面

功能	描述
直观的 WebView 界面	现代化的三栏式布局，操作便捷
多视图切换	支持团队 Skill、已安装、设置三个视图快速切换
实时状态显示	Skill 安装、更新、卸载状态实时反馈
搜索过滤功能	快速搜索和过滤 Skill 列表

配置选项

配置项	类型	默认值	描述
`cursorTeamSkill.autoUpdate`	boolean	true	是否自动检查更新
`cursorTeamSkill.updateInterval`	number	60	更新检查间隔（分钟）
`cursorTeamSkill.showNotifications`	boolean	true	是否显示通知
`cursorTeamSkill.storagePath`	string	""	Skill 存储路径（留空使用默认路径）
`cursorTeamSkill.proxy`	string	""	代理服务器地址

安装

方式一：从源码安装

克隆本仓库到本地
进入项目目录
安装依赖：npm install
编译项目：npm run compile
在 Cursor 中加载插件：
- 打开 Cursor 设置
- 选择 "Developer: Install Extension from Location"
- 选择编译后的 dist 目录

方式二：本地打包安装

克隆本仓库到本地
进入项目目录
安装依赖：npm install
打包：npm run vscode:prepublish
在 Cursor 扩展页面点击 "Install from VSIX"

使用指南

快速开始

1. 打开插件界面

使用快捷键 Ctrl+Shift+P（Mac: Cmd+Shift+P）
输入 Team Skill Manager: 打开主面板
或直接点击侧边栏的 Team Skill Manager 图标

2. 添加 Skill 源

点击界面右上角的 "添加源" 按钮
输入源名称和地址
选择认证方式（如需要）
点击 "添加"

3. 安装 Skill

在 "团队 Skill" 标签页浏览可用 Skill
点击 "安装" 按钮开始安装
安装进度会在界面中实时显示

4. 同步更新

点击 "同步全部" 按钮同步所有 Skill
或使用命令 Team Skill Manager: 同步所有 Skill

命令面板

插件提供以下命令，可在命令面板中直接调用：

命令	描述
`Team Skill Manager: 打开主面板`	打开插件主界面
`Team Skill Manager: 安装 Skill`	安装指定的 Skill
`Team Skill Manager: 更新 Skill`	更新指定的 Skill
`Team Skill Manager: 卸载 Skill`	卸载指定的 Skill
`Team Skill Manager: 同步所有 Skill`	同步所有已安装的 Skill
`Team Skill Manager: 检查更新`	检查可用更新
`Team Skill Manager: 添加 Skill 源`	添加新的 Skill 源
`Team Skill Manager: 测试源连接`	测试源的连接状态
`Team Skill Manager: 刷新源列表`	刷新源列表
`Team Skill Manager: 打开设置`	打开插件设置

API 接口

插件通过 WebView 与后端通信，支持以下消息类型：

请求消息

类型	描述	载荷
`getSources`	获取所有 Skill 源	-
`getSkills`	获取 Skill 列表	`{ sourceId?: string }`
`installSkill`	安装 Skill	`{ skillId: string }`
`updateSkill`	更新 Skill	`{ skillId: string }`
`removeSkill`	卸载 Skill	`{ skillId: string }`
`syncAll`	同步所有 Skill	-
`addSource`	添加源	`{ name, url, authType }`
`removeSource`	移除源	`{ sourceId: string }`
`testSource`	测试源连接	`{ sourceId: string }`
`getConfig`	获取配置	-
`updateConfig`	更新配置	配置对象
`refreshData`	刷新数据	-

响应消息

类型	描述	载荷
`initialData`	初始数据	包含 sources、skills、localSkills、config
`sourcesData`	源列表数据	源配置数组
`skillsData`	Skill 列表数据	包含 skills 和 quickInfo
`skillOperationStart`	操作开始	`{ skillId, operation }`
`skillOperationComplete`	操作完成	`{ skillId, operation }`
`skillOperationError`	操作错误	`{ skillId, error }`
`syncStart`	同步开始	-
`syncComplete`	同步完成	`{ success, message, updated }`
`sourceAdded`	源已添加	`{ success, error? }`
`sourceRemoved`	源已移除	`{ success, error? }`
`sourceTestStart`	测试开始	`{ sourceId }`
`sourceTestComplete`	测试完成	测试结果
`configData`	配置数据	配置对象
`configUpdated`	配置已更新	`{ success, error? }`
`error`	错误消息	`{ message }`

开发

项目结构

cursor-team-skill-manager/
├── .cursor-plugin/
│   └── marketplace.json          # Cursor 插件市场配置
├── src/
│   ├── extension.ts              # 插件主入口
│   ├── commands/
│   │   ├── index.ts              # 命令注册入口
│   │   ├── skillCommands.ts     # Skill 相关命令
│   │   └── configCommands.ts    # 配置相关命令
│   ├── services/
│   │   ├── skillService.ts      # Skill 业务逻辑
│   │   ├── downloadService.ts   # 下载服务
│   │   ├── cacheService.ts      # 缓存管理
│   │   ├── sourceService.ts     # 源管理服务
│   │   └── configService.ts     # 配置服务
│   ├── models/
│   │   ├── skill.ts             # Skill 数据模型
│   │   ├── source.ts            # Skill 源模型
│   │   └── config.ts            # 配置模型
│   ├── webview/
│   │   ├── panel.ts             # WebView 面板管理
│   │   └── html.ts              # WebView HTML 内容
│   ├── utils/
│   │   ├── logger.ts            # 日志工具
│   │   └── helpers.ts           # 辅助函数
│   └── constants.ts             # 常量定义
├── resources/
│   └── icons/                    # 图标资源
├── package.json                 # npm 包配置
├── tsconfig.json                 # TypeScript 配置
├── SPEC.md                      # 技术规范
└── README.md                     # 说明文档

开发命令

# 安装依赖
npm install

# 编译项目
npm run compile

# 监听模式编译
npm run watch

# 运行测试
npm test

# 代码检查
npm run lint

调试

在 VS Code 中打开项目
按 F5 启动调试
在 "Extension Development Host" 窗口中测试插件

数据存储

插件数据存储在以下位置：

Windows: %USERPROFILE%\.cursor\extensions\cursor-team-skill-manager\
macOS: ~/.cursor/extensions/cursor-team-skill-manager/
Linux: ~/.cursor/extensions/cursor-team-skill-manager/

数据目录结构：

data/
├── cache/
│   ├── metadata.json           # 缓存元数据
│   └── skills/                 # Skill 文件
└── cursor-team-skill-manager.log  # 日志文件

安全说明

敏感信息（如 API Key、密码）使用 VS Code SecretStorage 加密存储
所有网络请求支持 HTTPS 协议
可配置 SSL 证书验证

常见问题

Q: 添加源后无法获取 Skill 列表？

A: 请检查：

源地址是否正确
网络连接是否正常
认证信息是否正确配置
使用 "测试源连接" 功能排查问题

Q: 安装失败怎么办？

A: 尝试以下步骤：

检查网络连接
清理缓存后重试
查看日志文件获取详细错误信息
如使用代理，确保代理配置正确

Q: 如何完全卸载插件？

在 Cursor 扩展页面禁用并卸载插件
删除插件数据目录（可选）

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License

Team Skill Manager

cy.ma