引言“AI 的边界取决于你给它装备了什么。”这是「一天一个开源项目」系列的第 69 篇文章。今天介绍的项目是second-brain-skillsGitHub。大多数人把 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 Medincoleam00公司DynamousAI 教育 工具公司YouTubeColeMedinAI Agent 实践内容创作者GitHub 粉丝6,500代表项目Archon13.9k Stars、context-engineering-intro13.1k Stars、ottomator-agents5.5k StarsCole 是 Claude Code 生态中最活跃的实践者之一专注于将 AI Agent 技术落地到真实工作场景尤其擅长工程化而非纯理论的内容。项目数据⭐GitHub Stars: 648Forks: 195最近更新: 2026 年 1 月License: 未明确声明版权归作者所有主要功能核心设计哲学渐进式上下文披露项目最重要的设计思想不是某个具体功能而是渐进式上下文披露Progressive Disclosure of Context只在需要时加载相关上下文而不是一开始就将所有信息塞进 context window。传统方式是把所有知识塞进 system prompt每次对话都消耗大量 token。second-brain-skills的做法是三层按需加载层级内容何时加载元数据层SKILL.md 的 YAML frontmattername description始终可见指令层SKILL.md 的 Markdown 正文详细工作流触发 Skill 时加载资源层scripts/、references/ 中的文件实际执行时按需读取这种设计让 Claude Code 能管理数十个 Skill同时保持每次对话的上下文精简高效。6 个核心 Skill1. Brand Voice Generator品牌与声音生成器为你的品牌/公司创建完整的品牌配置系统输出 4 个标准化文件brand.json— 颜色、字体、视觉规范config.json— 品牌元数据brand-system.md— 完整品牌系统文档tone-of-voice.md— 品牌声音与语调指南这 4 个文件成为项目的品牌单一真相来源后续 PPTX Generator、内容创作等 Skill 都基于此保持一致性。2. PPTX GeneratorPPT 生成器生成品牌一致的专业幻灯片内置16 种视觉优先的幻灯片布局彻底告别传统的文字堆砌风格模板类型适用场景title-slide封面页stats-slide数据大屏circular-hero-slide产品/人物焦点floating-cards-slide多要素并列code-slide技术展示chart-slide数据可视化quote-slide引用/金句two-column-slide对比分析支持 LinkedIn 轮播图格式正方形适合社交媒体内容创作。3. SOP CreatorSOP 文档生成器生成结构化的操作手册、技术文档和 Runbook适用场景团队操作流程文档化技术 Runbook 和应急手册产品 Playbook新员工入职指南4. Skill CreatorSkill 创建向导引导你创建符合框架规范的自定义 Skill内置最佳实践检查确保新 Skill 遵循渐进式上下文披露原则。5. MCP ClientMCP 客户端通过统一接口连接外部 MCP 服务器支持4 种传输协议stdio本地子进程命令行工具SSE服务器推送事件Streamable HTTPHTTP 流式传输FastMCPBearer Token 认证开箱支持 Zapier、GitHub、Sequential Thinking 等常见 MCP 服务器。6. Remotion Video Creator视频生成器用 React 组件程序化生成视频通过 Remotion 框架将代码转换为 MP4适合产品演示视频数据可视化动画社交媒体短视频内容快速开始# 克隆仓库gitclone https://github.com/coleam00/second-brain-skills.git# 方式一直接在当前项目中使用# 把 .claude/ 目录复制到你的项目根目录cp-rsecond-brain-skills/.claude /your-project/# 方式二在仓库目录中打开 Claude Code 使用cdsecond-brain-skills# 直接打开 Claude Code 即可配置 MCP Client可选cd.claude/skills/mcp-client/references/cpexample-mcp-config.json mcp-config.json# 编辑 mcp-config.json填入你的 API Key安装 Python 依赖MCP Client 需要pipinstallmcp fastmcp使用方式——在 Claude Code 中直接用自然语言触发帮我为 WonderLab 生成品牌配置 → 触发 Brand Voice Generator 基于品牌配置制作一个 AI 趋势报告的 PPT → 触发 PPTX Generator 为我们的 Docker 部署流程写一份 Runbook → 触发 SOP Creator 连接 Zapier MCP列出可用的 Action → 触发 MCP Client项目优势对比维度second-brain-skillsRAG 方案直接写 System Prompt上下文效率✅ 按需加载一般检索质量依赖❌ 全量加载部署复杂度✅ 复制目录即用高需向量数据库✅ 低扩展性✅ 新增 Skill 文件中❌ 需修改 Prompt工作流一致性✅ Skill 固化最佳实践—❌ 每次需重新描述适用场景固定专业任务非结构化知识查询临时对话项目详细剖析Skill 文件结构解剖每个 Skill 遵循统一的目录约定.claude/skills/ └── skill-name/ ├── SKILL.md # 必须触发条件 工作流指令 ├── scripts/ # 可选可执行脚本确定性操作 ├── references/ # 可选参考文档运行时按需加载 └── assets/ # 可选模板文件不自动加载进 contextSKILL.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简化示意frompptximportPresentationfrompptx.utilimportInches,Ptfrompptx.dml.colorimportRGBColordefcreate_stats_slide(prs,brand_config,stats_data): 创建数据统计幻灯片 brand_config: 从 brand.json 加载的品牌配置 stats_data: [{label: 用户数, value: 10,000, growth: 23%}] slide_layoutprs.slide_layouts[6]# 空白布局slideprs.slides.add_slide(slide_layout)# 应用品牌背景色bg_colorRGBColor.from_string(brand_config[colors][background])# ... 渲染统计数字、增长指标等这种食谱化设计的优势每个布局独立维护互不干扰Claude 可以自主组合多种布局生成完整 PPT用户可以添加自定义布局无需修改核心逻辑MCP Client 的统一接口设计mcp_client.py用 Pythonasyncio实现了对 4 种传输协议的统一抽象# scripts/mcp_client.py简化示意fromcontextlibimportasynccontextmanagerfrommcpimportClientSession,StdioServerParametersfrommcp.client.stdioimportstdio_clientfrommcp.client.sseimportsse_clientasynccontextmanagerasyncdefconnect_to_server(server_config:dict):统一连接接口根据配置自动选择传输协议transportserver_config.get(transport,stdio)iftransportstdio:paramsStdioServerParameters(commandserver_config[command],argsserver_config.get(args,[]),envserver_config.get(env))asyncwithstdio_client(params)as(read,write):asyncwithClientSession(read,write)assession:awaitsession.initialize()yieldsessioneliftransportin(sse,streamable-http):asyncwithsse_client(urlserver_config[url],headersserver_config.get(headers,{}))as(read,write):asyncwithClientSession(read,write)assession:awaitsession.initialize()yieldsession配置文件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: https://github.com/coleam00/second-brain-skills作者 YouTube: ColeMedin含使用教程视频Issue Tracker: https://github.com/coleam00/second-brain-skills/issues作者其他相关项目Archon13.9k ⭐: 确定性 AI Agent 框架context-engineering-intro13.1k ⭐: AI 上下文工程技术教程mcp-crawl4ai-rag2.1k ⭐: 网页爬取 RAG 方案总结与展望核心要点回顾渐进式上下文披露三层按需加载机制比全塞 system prompt高效数倍是最值得借鉴的设计思想Skills as Markdown用 Markdown 定义 AI 工作流零代码门槛任何人都能创建专属 Skill品牌系统集成Brand Skill → PPTX Skill 的工作流将品牌一致性做成可执行的自动化流程MCP 统一抽象4 种传输协议的统一接口让连接外部服务变得像写配置文件一样简单独立开发者友好项目定位与一人公司高度契合从内容创作到技术文档全覆盖适用人群独立开发者 / 一人公司需要同时处理技术、内容、品牌的全栈知识工作者内容创作者需要批量生成品牌一致的 PPT、文档的创作者技术写作者负责维护大量 SOP、Runbook、操作手册的工程师Claude Code 深度用户想把 Claude Code 改造成专属工作平台的探索者欢迎来我的个人主页找到更多有用的知识和有趣的产品