SkillBubble — Skills Management MCP Server

SkillBubble 集成

将 SkillBubble 连接到你的 AI 助手或开发工作流，让你的技能档案在开发过程中保持最新。

有两种方式可供选择，请挑选适合你的方案。

---

选项 1 — AI 助手（推荐）

通过 MCP 服务，将你的个人 AI 助手（Kiro、Claude、Copilot）连接到 SkillBubble 档案。这样一来，助手便能读取你的档案，根据你正在开发的内容建议更新技能，并在你工作时让档案保持最新——一切都由你通过对话掌控。

这是主要集成方式。 它专为个人设计，使用方式明确，而且一切都由你掌控。

→ 设置 AI 助手

---

选项 2 — GitHub Sync

在设置中连接你的 GitHub 账号，SkillBubble 会自动分析你的个人贡献历史记录——提交、编程语言、仓库活动——并在收件箱中生成技能建议。

对于自动更新档案，这是推荐的方式。它比 CI/CD 流水线更简洁，因为 SkillBubble 会直接获取你的数据，且仅限于你的个人数据，不需要在共享仓库中存放密钥。

→ 了解 GitHub Sync

---

⚠️ 流水线集成 — 请先阅读

此仓库中的 GitHub Actions 工作流允许你在推送代码或创建 PR 时触发技能建议。这些工作流仅适用于个人使用的单人开发仓库。

请勿将 SkillBubble API 密钥添加到共享团队仓库中。 否则：

• 团队每位成员的每次推送都会针对你的档案触发建议
• 同事的工作会显示为你的技能活动
• 你会收到大量不相关的建议

如果你希望根据自己在共享仓库中的工作自动更新，请改用 GitHub Sync（选项 2）——它只会读取你的个人贡献，而非整个团队的贡献。

如果你有合理的单用户仓库使用场景，下面提供了流水线工作流的说明。

---

AI 助手设置

前提条件

• 一个 SkillBubble 账号 — 免费注册
• Pro 订阅，以使用写入和 AI 工具
• 一个 API 密钥 — 在 Settings → Integrations 中生成

1. 获取 API 密钥

登录 → Settings → Integrations → Create API key。

2. 添加到客户端

从 mcp-config/ 中选择适用于你的 AI 助手的配置：

文件	客户端
kiro.json	Kiro IDE（~/.kiro/settings/mcp.json）
claude.json	Claude Desktop / Claude Code
copilot.json	GitHub Copilot（VS Code — .vscode/mcp.json）

将 sk-sb-your-api-key-here 替换为你在设置中获取的密钥。

3. 试用

向你的 AI 助手提问：

“显示我的 SkillBubble 档案——我的技能评分最高的是哪些？”

---

可以向 AI 助手提出什么问题

连接后，你的 AI 助手便可全面访问你的技能档案。下面是一些入门提示词：

档案审查

Show me my SkillBubble profile. What are my strongest skills?

Summarise my top skills for a CV profile summary. Keep it to 3 sentences.

What skills am I missing compared to a senior TypeScript engineer?

保持档案最新

I just finished building a React dashboard with Recharts and React Query.
Use suggestSkills with that context and update my profile.

Read my package.json and suggest skills for the libraries I'm actively using.
Then call createSkillRating for each relevant one.

Run: git diff main --stat
Then: git diff main -- '*.ts' '*.tsx' | head -300
What did I build in this branch? Suggest and apply skill updates.

差距分析

Call getSkillProfile, then run git log --oneline -20.
Compare what I've been building against my profile and suggest updates for anything I'm missing.

职业规划

How ready am I for a Senior Cloud Architect role? Use roleGapAnalysis.

Generate a 30/60/90-day learning plan to close my gaps against my AWS package.

What are the top 3 skills I should focus on to become a Staff Engineer?
Use prioritySkillRecommendations with that career goal.

---

可用工具

工具	级别	描述
getSkillProfile	免费	读取技能，支持按类别、评分或日期筛选
getCertifications	免费	列出认证，可按颁发机构或有效／过期状态筛选
getFrameworks	免费	查看能力框架和进度
getSkillHistory	免费	查看评分随时间的变化
searchSkills	免费	按名称或类别搜索
getSubscribedPackages	免费	列出所有已订阅的技能包及其类别和技能
gapAnalysis	免费	将你的技能与某个技能包进行比较，找出差距和优势
strengthsWeaknesses	免费	显示你最强和最弱的 3 个技能类别
frameworkGapAnalysis	免费	将你的证据与某个能力框架进行比较
createSkillRating	专业版	添加或更新技能评分
updateSkillRating	专业版	按技能键更新现有评分
createCertification	专业版	添加认证记录
createSkillPackage	专业版	创建自定义技能包
manageSuggestions	专业版	列出、接受或拒绝待处理的技能建议
suggestSkills	专业版	根据上下文字符串提供 AI 技能建议——不会造成破坏性更改
suggestSkillPackage	专业版	根据目标推荐技能包——不会造成破坏性更改
roleGapAnalysis	专业版	使用 AI 分析你胜任目标职位的准备情况
generateLearningPlan	专业版	根据技能差距生成 30／60／90 天学习计划
prioritySkillRecommendations	专业版	获取为实现职业目标下一步最值得提升的 3 项技能

AI 驱动的工具（suggestSkills、suggestSkillPackage、roleGapAnalysis、generateLearningPlan、prioritySkillRecommendations）只会返回建议，不会自动修改你的个人资料。

---

GitHub 同步

GitHub 同步通过 OAuth 将你的 GitHub 账号连接到 SkillBubble。连接后，SkillBubble 会定期分析你的个人贡献历史（包括语言、提交活动和仓库主题），并在你的收件箱中生成技能建议。

为什么这比流水线更好：

• 仅针对你的个人贡献，而不是整个团队
• 共享仓库中无需存放 API 密钥
• 自动运行，无需维护工作流文件
• 建议会进入你的收件箱供你审核，与 MCP 建议相同

你可以在设置 → 集成中找到此功能。

团队用户？ GitHub 同步用于根据你自己的贡献更新个人资料。如果你需要面向整个团队的技能分析（差距报告、冲刺规划建议、任务分配建议），这将由团队 AI 自动化提供（商业订阅）。了解详情。

---

GitHub Actions（仅限单用户仓库）

⚠️ 仅供个人使用。 使用前，请参阅上文的流水线警告。

需要面向整个团队的自动化？ 流水线工作流并不适合这种用途。请查看团队 AI 自动化——它正是为此类用途打造的，同时不会带来凭据风险。

可在 github-actions/ 中直接使用的工作流：

工作流	触发条件
on-merge.yml	推送到 main
on-pr.yml	拉取请求新建／更新
dependency-scan.yml	手动触发或依赖文件变更

设置： 在仓库中添加以下机密（设置 → 机密 → Actions）：

机密	值
SKILLBUBBLE_API_KEY	你在 SkillBubble 设置中获取的个人 API 密钥
SKILLBUBBLE_MCP_ENDPOINT	https://mcp.skillbubble.com/mcp

或者直接使用该 Action：

- uses: Skill-Bubble/skillbubble-integrations@v1
  with:
    api_key: ${{ secrets.SKILLBUBBLE_API_KEY }}
    mcp_endpoint: ${{ secrets.SKILLBUBBLE_MCP_ENDPOINT }}

---

团队 AI 自动化 （即将推出 — 面向企业的订阅）

团队 AI 自动化将技能智能直接引入 SkillBubble，供整个团队使用 — 无需团队成员单独配置 MCP。

公司管理员为组织启用一个共享的自动化账户。团队成员可选择共享自己的技能数据，SkillBubble 会按计划运行 AI 驱动的分析，并在关键事件发生时进行分析：

• 冲刺规划 — “你的团队在 Terraform 方面存在技能缺口。近期有 3 名成员提升了技能 — 正是解决基础设施积压问题的好时机。”
• 功能规划 — 描述一项新功能，即可根据相关技能最强的成员获取分配建议。
• 每周技能缺口报告 — 为团队所有者提供汇总的技能缺口和技能提升机会报告，不会暴露个人评级。
• 新成员入职 — 有人加入团队时，会自动运行分析。

建议会显示在每位成员现有的建议收件箱中，并标记为“Team AI”，沿用他们熟悉的接受 / 拒绝流程。

这是适合团队的解决方案 — 而不是使用共享 API 密钥的流水线工作流。企业订阅套餐包含此功能。

---

数据与安全

• 所有流量均通过 HTTPS / TLS 1.2+ 加密
• API 密钥按权限范围限定 — 只读密钥无法调用写入工具
• 写入工具遵循“设置”中的 MCP 信任级别：在 ask 模式（默认）下，写入调用会创建待审核建议，而非直接应用更改
• 随时可在设置 → 集成中撤销任何密钥

提示词注入风险： LLM 可能会受到文件或提交中恶意内容的操纵。请保留默认的 ask 信任级别，以确保所有写入调用在应用前都需要经过你的审核。

完整详情请参阅 SECURITY.md。

---

支持

• 电子邮箱：[email protected]
• 设置：www.skillbubble.com/settings/integrations

---

贡献

此仓库由 SkillBubble 团队维护。目前不接受外部贡献。

---

免责声明

MCP 客户端可以根据你的 API 密钥权限读取和写入你的 SkillBubble 个人资料。请保留默认的 ask 信任级别，在接受建议前先进行审核，并撤销不再使用的密钥。