Byterover 技能

一组专用于增强知识管理的 Claude Code 技能，适用于 Byterover MCP 服务器。

概述

Byterover 是什么？

Byterover 是一个AI记忆系统，它支持在对话之间持久存储和检索知识。它允许AI代理：

• 存储编程事实、模式和解决方案
• 从过去的对话中检索相关上下文
• 随时间累积知识
• 在不同的项目间共享知识

graph LR
    A[AI 对话] -->|存储| B[Byterover 记忆]
    B -->|检索| C[未来对话]
    C -->|存储| B

Byterover 技能是什么？

技能通过专门的工作流程扩展了 Byterover 的核心功能：

• 结构化文档生成（报告、PRD、架构文档）
• 双向集成（Notion、GitHub 等）
• 高级知识合成（聚合、格式化、分析）
• 自动化工作流用于常见的知识管理工作

graph TB
    A[Byterover 核心] --> B[byterover-notion-sync]
    A --> C[未来技能]
    B --> D["记忆 ↔ Notion"]
    C --> E[会议、GitHub、代码]

---

安装

先决条件

1. Claude Code - 从 claude.ai/claude-code 安装
2. Byterover MCP 服务器 - 从 byterover.dev 设置
3. Notion MCP 服务器（可选）- 需要 byterover-notion-sync（设置指南）

安装技能

克隆并复制技能到您的 Claude Code 目录：

# 克隆仓库
git clone https://github.com/RyanNg1403/byterover-skills.git
cd byterover-skills

# 复制单个技能
cp -r byterover-notion-sync ~/.claude/skills/

# 或者复制所有技能
cp -r */ ~/.claude/skills/

验证安装

启动 Claude Code 并询问：“有哪些可用的 Byterover 技能？”

---

技能

🔄 byterover-notion-sync

在 Byterover 记忆与 Notion 文档之间进行双向知识同步。

核心能力：

• 将记忆转换为 Notion 文档（四种格式：实施报告、PRD、特性文档、架构文档）
• 导入 Notion 页面为可搜索的记忆，智能分块
• 多查询检索以获得全面的上下文
• 根据内容自动选择格式

架构：

graph TB
    subgraph mem2notion["记忆 → Notion"]
        A[Byterover 记忆] -->|多查询| B[聚合上下文]
        B -->|格式选择| C{文档类型}
        C -->|基于时间线| D[实施报告]
        C -->|需求| E[PRD]
        C -->|使用指南| F[特性文档]
        C -->|系统设计| G[架构文档]
        D --> H[Notion 页面]
        E --> H
        F --> H
        G --> H
    end

    subgraph notion2mem["Notion → 记忆"]
        I[Notion 页面] -->|获取| J[分析结构]
        J -->|分块| K[逻辑部分]
        K -->|格式化| L[记忆模板]
        L -->|存储| M[Byterover 记忆]
    end

示例用例：

“创建7月10日至15日的身份验证系统的实施报告”
“将我们的通知讨论转化为PRD”
“记录微服务架构”
“从Notion导入API文档到记忆”

文档：

• SKILL.md - 完整的工作流程指南
• references/ - 格式模板和指南

工作流程概述：

sequenceDiagram
    participant U as 用户
    participant C as Claude
    participant B as Byterover
    participant N as Notion

    Note over U,N: 记忆到Notion
    U->>C: 创建实施报告
    C->>B: 多查询记忆
    B-->>C: 聚合结果
    C->>C: 选择格式和结构
    C->>N: 创建Notion页面
    N-->>U: 返回页面链接

    Note over U,N: Notion到记忆
    U->>C: 导入Notion页面
    C->>N: 获取页面内容
    N-->>C: 返回结构化内容
    C->>C: 分块和格式化
    C->>B: 存储记忆
    B-->>U: 确认存储

---

使用

技能会根据您的请求自动激活 - 不需要特殊命令。

示例工作流程：

# 从记忆生成文档
用户: “创建我们上周构建的支付系统的实施报告”
→ 查询记忆 → 结构化为报告 → 创建带有时间线的Notion页面

# 将文档导入记忆
用户: “将我们的API文档从Notion导入记忆”
→ 获取Notion页面 → 分块 → 存储为可搜索的记忆

# 架构文档
用户: “基于最近的工作记录我们的微服务架构”
→ 检索架构记忆 → 结构化为图表 → 创建Notion文档

---

贡献

添加新技能

1. 叉出此仓库
2. 创建技能，遵循以下结构：

   your-skill-name/
   ├── SKILL.md          # 必需：工作流程说明
   ├── references/       # 可选：模板和指南
   ├── scripts/          # 可选：可执行辅助工具
   └── assets/           # 可选：资源
   

3. 更新此README中的技能描述
4. 提交拉取请求

详情参见 CONTRIBUTING.md。

---

发展路线图

计划中的技能：

• byterover-github-integration - 同步PR讨论、代码评论和问题到记忆
• byterover-meeting-notes - 将会议记录转换为结构化的记忆和行动项
• byterover-code-knowledge - 提取代码模式、架构决策和最佳实践
• byterover-research-synthesis - 将记忆聚合为研究报告和文献综述

有技能想法？打开一个问题或贡献！

---

许可证

MIT 许可证 - 详情见 LICENSE。

致谢

• 由 Anthropic 为 Claude Code 打造
• 由 Byterover MCP 服务器 动力支持
• 与 Notion MCP 集成