一天一个开源项目（第69篇）：second-brain-skills - 把 Claude Code 变成知识工作专家的 Skill 工具集

引言

"AI 的边界，取决于你给它装备了什么。"

这是「一天一个开源项目」系列的第 69 篇文章。今天介绍的项目是 second-brain-skills（GitHub）。

大多数人把 Claude Code 当作编程工具——写代码、调 Bug、重构。但如果你是个内容创作者、独立开发者，或者需要同时应对技术文档、演示汇报、品牌建设的"一人公司"，你会发现 Claude Code 的默认能力只覆盖了工作的一小部分。

second-brain-skills 改变了这个现状。这个项目由 AI Agent 工程师 Cole Medin 开源，通过一套精心设计的 Claude Code Skills，将 AI 助手从编程专家升级为全能知识工作搭档：它能生成品牌规范、制作专业 PPT、编写操作手册、连接外部 MCP 服务、甚至用代码生成视频——而且这一切都遵循"渐进式上下文披露"原则，不浪费宝贵的 context window。

你将学到什么

"第二大脑"（Second Brain）概念在 AI 工作流中的新诠释
Claude Code Skill 的设计哲学：渐进式上下文披露机制
6 个生产就绪 Skill 的功能与使用方式
如何通过 MCP Client Skill 连接 Zapier、GitHub 等外部服务
如何基于此框架构建自己的专属 Skill

前置知识

熟悉 Claude Code 的基本使用
了解 Markdown 语法
Python 基础（MCP Client 需要）

项目背景

项目简介

"第二大脑"（Second Brain）是个人知识管理领域的经典概念，由 Tiago Forte 在《打造第二大脑》中系统阐述——将数字系统作为大脑的延伸，系统化地捕获、整理和运用知识。

second-brain-skills 将这个概念嫁接到 AI 工作流：通过 Claude Code 的 Skill 机制，让 AI 在需要某个专业领域能力时，动态加载对应的指令、模板和工具，成为真正意义上的"第二大脑"延伸。

与常见的 RAG 方案不同，这个项目不依赖向量数据库或检索系统，而是通过精心结构化的 Markdown 文件，实现按需加载上下文。

作者介绍

作者：Cole Medin（coleam00）
公司：Dynamous（AI 教育 & 工具公司）
YouTube：@ColeMedin（AI Agent 实践内容创作者）
GitHub 粉丝：6,500+
代表项目：Archon（13.9k Stars）、context-engineering-intro（13.1k Stars）、ottomator-agents（5.5k Stars）

Cole 是 Claude Code 生态中最活跃的实践者之一，专注于将 AI Agent 技术落地到真实工作场景，尤其擅长工程化而非纯理论的内容。

项目数据

⭐ GitHub Stars: 648
🍴 Forks: 195
🔄 最近更新: 2026 年 1 月
📄 License: 未明确声明（版权归作者所有）

主要功能

核心设计哲学：渐进式上下文披露

项目最重要的设计思想不是某个具体功能，而是渐进式上下文披露（Progressive Disclosure of Context）：

只在需要时加载相关上下文，而不是一开始就将所有信息塞进 context window。

传统方式是把所有知识塞进 system prompt，每次对话都消耗大量 token。second-brain-skills 的做法是三层按需加载：

层级	内容	何时加载
元数据层	SKILL.md 的 YAML frontmatter（name + description）	始终可见
指令层	SKILL.md 的 Markdown 正文（详细工作流）	触发 Skill 时加载
资源层	scripts/、references/ 中的文件	实际执行时按需读取

这种设计让 Claude Code 能管理数十个 Skill，同时保持每次对话的上下文精简高效。

6 个核心 Skill

1. Brand & Voice Generator（品牌与声音生成器）

为你的品牌/公司创建完整的品牌配置系统，输出 4 个标准化文件：

brand.json — 颜色、字体、视觉规范
config.json — 品牌元数据
brand-system.md — 完整品牌系统文档
tone-of-voice.md — 品牌声音与语调指南

这 4 个文件成为项目的"品牌单一真相来源"，后续 PPTX Generator、内容创作等 Skill 都基于此保持一致性。

2. PPTX Generator（PPT 生成器）

生成品牌一致的专业幻灯片，内置 16 种视觉优先的幻灯片布局，彻底告别传统的"文字堆砌"风格：

模板类型	适用场景
`title-slide`	封面页
`stats-slide`	数据大屏
`circular-hero-slide`	产品/人物焦点
`floating-cards-slide`	多要素并列
`code-slide`	技术展示
`chart-slide`	数据可视化
`quote-slide`	引用/金句
`two-column-slide`	对比分析

支持 LinkedIn 轮播图格式（正方形），适合社交媒体内容创作。

3. SOP Creator（SOP 文档生成器）

生成结构化的操作手册、技术文档和 Runbook，适用场景：

团队操作流程文档化
技术 Runbook 和应急手册
产品 Playbook
新员工入职指南

4. Skill Creator（Skill 创建向导）

引导你创建符合框架规范的自定义 Skill，内置最佳实践检查，确保新 Skill 遵循渐进式上下文披露原则。

5. MCP Client（MCP 客户端）

通过统一接口连接外部 MCP 服务器，支持 4 种传输协议：

stdio：本地子进程（命令行工具）
SSE：服务器推送事件
Streamable HTTP：HTTP 流式传输
FastMCP：Bearer Token 认证

开箱支持 Zapier、GitHub、Sequential Thinking 等常见 MCP 服务器。

6. Remotion Video Creator（视频生成器）

用 React 组件程序化生成视频，通过 Remotion 框架将代码转换为 MP4，适合：

产品演示视频
数据可视化动画
社交媒体短视频内容

快速开始

# 克隆仓库
git clone https://github.com/coleam00/second-brain-skills.git

# 方式一：直接在当前项目中使用
# 把 .claude/ 目录复制到你的项目根目录
cp -r second-brain-skills/.claude /your-project/

# 方式二：在仓库目录中打开 Claude Code 使用
cd second-brain-skills
# 直接打开 Claude Code 即可

配置 MCP Client（可选）：

cd .claude/skills/mcp-client/references/
cp example-mcp-config.json mcp-config.json
# 编辑 mcp-config.json，填入你的 API Key

安装 Python 依赖（MCP Client 需要）：

pip install mcp fastmcp

使用方式——在 Claude Code 中直接用自然语言触发：

"帮我为 WonderLab 生成品牌配置"
→ 触发 Brand & Voice Generator

"基于品牌配置，制作一个 AI 趋势报告的 PPT"
→ 触发 PPTX Generator

"为我们的 Docker 部署流程写一份 Runbook"
→ 触发 SOP Creator

"连接 Zapier MCP，列出可用的 Action"
→ 触发 MCP Client

项目优势

对比维度	second-brain-skills	RAG 方案	直接写 System Prompt
上下文效率	✅ 按需加载	一般（检索质量依赖）	❌ 全量加载
部署复杂度	✅ 复制目录即用	高（需向量数据库）	✅ 低
扩展性	✅ 新增 Skill 文件	中	❌ 需修改 Prompt
工作流一致性	✅ Skill 固化最佳实践	—	❌ 每次需重新描述
适用场景	固定专业任务	非结构化知识查询	临时对话

项目详细剖析

Skill 文件结构解剖

每个 Skill 遵循统一的目录约定：

.claude/skills/
└── skill-name/
    ├── SKILL.md          # 必须：触发条件 + 工作流指令
    ├── scripts/          # 可选：可执行脚本（确定性操作）
    ├── references/       # 可选：参考文档（运行时按需加载）
    └── assets/           # 可选：模板文件（不自动加载进 context）

SKILL.md 的结构（以 SOP Creator 为例）：

---
name: SOP Creator
description: Creates runbooks, playbooks, and technical documentation
---

## 触发条件
当用户需要创建操作手册、Runbook、Playbook 或技术文档时激活。

## 工作流

### 1. 收集信息
首先询问：
- 文档类型（Runbook / Playbook / SOP / 入职指南）
- 目标受众
- 核心流程或场景

### 2. 结构生成
按照以下模板生成文档结构：
- 概述与目的
- 前置条件
- 步骤说明（含命令示例）
- 故障排除
- 相关文档链接

### 3. 格式规范
- 使用 Markdown
- 命令用代码块包裹
- 关键步骤加警告标注

YAML frontmatter 的 description 字段是 Claude Code 决定何时激活这个 Skill 的关键——它就是 Skill 的"触发词典"。

PPTX Generator 的 Cookbook 机制

PPTX Generator 的核心创新是 Cookbook（食谱库） 设计。每个幻灯片布局是一个独立的 Python 脚本，Claude 在生成 PPT 时按需选择和组合：

# cookbook/stats-slide.py（简化示意）
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor

def create_stats_slide(prs, brand_config, stats_data):
    """
    创建数据统计幻灯片
    brand_config: 从 brand.json 加载的品牌配置
    stats_data: [{"label": "用户数", "value": "10,000", "growth": "+23%"}]
    """
    slide_layout = prs.slide_layouts[6]  # 空白布局
    slide = prs.slides.add_slide(slide_layout)

    # 应用品牌背景色
    bg_color = RGBColor.from_string(brand_config["colors"]["background"])
    # ... 渲染统计数字、增长指标等

这种"食谱化"设计的优势：

每个布局独立维护，互不干扰
Claude 可以自主组合多种布局生成完整 PPT
用户可以添加自定义布局，无需修改核心逻辑

MCP Client 的统一接口设计

mcp_client.py 用 Python asyncio 实现了对 4 种传输协议的统一抽象：

# scripts/mcp_client.py（简化示意）
from contextlib import asynccontextmanager
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from mcp.client.sse import sse_client

@asynccontextmanager
async def connect_to_server(server_config: dict):
    """统一连接接口，根据配置自动选择传输协议"""
    transport = server_config.get("transport", "stdio")

    if transport == "stdio":
        params = StdioServerParameters(
            command=server_config["command"],
            args=server_config.get("args", []),
            env=server_config.get("env")
        )
        async with stdio_client(params) as (read, write):
            async with ClientSession(read, write) as session:
                await session.initialize()
                yield session

    elif transport in ("sse", "streamable-http"):
        async with sse_client(url=server_config["url"],
                              headers=server_config.get("headers", {})) as (read, write):
            async with ClientSession(read, write) as session:
                await session.initialize()
                yield session

配置文件（mcp-config.json）示例：

{
  "mcpServers": {
    "zapier": {
      "transport": "sse",
      "url": "https://mcp.zapier.com/api/v1/connect",
      "headers": {
        "Authorization": "Bearer YOUR_ZAPIER_API_KEY"
      }
    },
    "sequential-thinking": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "github": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Brand System：品牌一致性的单一真相来源

Brand & Voice Generator 输出的 4 个文件形成一个互相关联的品牌系统：

brands/
└── your-brand/
    ├── brand.json         # 视觉规范（颜色、字体、间距）
    ├── config.json        # 品牌元数据（名称、行业、目标用户）
    ├── brand-system.md    # 完整品牌指南（人类可读）
    └── tone-of-voice.md   # 声音风格（正式/亲切/专业等）

brand.json 示例：

{
  "name": "WonderLab",
  "colors": {
    "background": "0A0A0A",
    "primary": "6366F1",
    "accent": "8B5CF6",
    "text": "F9FAFB",
    "muted": "6B7280"
  },
  "fonts": {
    "heading": "Inter",
    "body": "Inter",
    "code": "JetBrains Mono"
  },
  "spacing": {
    "slide_padding": 60,
    "element_gap": 24
  }
}

后续 PPTX Generator 会自动读取这个文件，确保每一张幻灯片都与品牌保持一致，无需每次重新描述颜色和字体。

项目地址与资源

官方资源

🌟 GitHub: github.com/coleam00/se…
🎬 作者 YouTube: @ColeMedin（含使用教程视频）
🐛 Issue Tracker: github.com/coleam00/se…

作者其他相关项目

Archon（13.9k ⭐）: 确定性 AI Agent 框架
context-engineering-intro（13.1k ⭐）: AI 上下文工程技术教程
mcp-crawl4ai-rag（2.1k ⭐）: 网页爬取 + RAG 方案

总结与展望

核心要点回顾

渐进式上下文披露：三层按需加载机制，比"全塞 system prompt"高效数倍，是最值得借鉴的设计思想
Skills as Markdown：用 Markdown 定义 AI 工作流，零代码门槛，任何人都能创建专属 Skill
品牌系统集成：Brand Skill → PPTX Skill 的工作流，将品牌一致性做成可执行的自动化流程
MCP 统一抽象：4 种传输协议的统一接口，让连接外部服务变得像写配置文件一样简单
独立开发者友好：项目定位与"一人公司"高度契合，从内容创作到技术文档全覆盖

适用人群

独立开发者 / 一人公司：需要同时处理技术、内容、品牌的全栈知识工作者
内容创作者：需要批量生成品牌一致的 PPT、文档的创作者
技术写作者：负责维护大量 SOP、Runbook、操作手册的工程师
Claude Code 深度用户：想把 Claude Code 改造成专属工作平台的探索者

欢迎来我的个人主页找到更多有用的知识和有趣的产品