---

name: knowledge-ops description: 知识库管理、摄取、同步和跨多个存储层（本地文件、MCP记忆、向量存储、Git仓库）的检索。当用户想要保存、组织、同步、去重或搜索其知识系统时使用。 origin: ECC

知识操作

管理多层知识系统，用于跨多个存储进行知识的摄取、组织、同步和检索。

优先使用实时工作区模型：

• 代码工作存放在实际克隆的仓库中
• 活跃执行上下文存放在GitHub、Linear和仓库本地的working-context文件中
• 更广泛的面向人类的笔记可以存放在非仓库的context/archive文件夹中
• 持久的跨机器记忆属于知识库，而非影子仓库工作区

何时激活

• 用户想要将信息保存到知识库
• 将文档、对话或数据摄取到结构化存储中
• 跨系统同步知识（本地文件、MCP记忆、Supabase、Git仓库）
• 对现有知识进行去重或组织
• 用户说"保存到KB"、"同步知识"、"我知道关于X的什么"、"摄取这个"、"更新知识库"
• 超出简单记忆回忆的任何知识管理任务

知识架构

第1层：活跃执行真相

• 来源： GitHub issues、PR、讨论、发布说明、Linear issues/项目/文档
• 用途： 工作的当前运营状态
• 规则： 如果某事影响活跃的工程计划、路线图、发布或版本，优先放在这里

第2层：Claude Code记忆（快速访问）

• 路径： ~/.claude/projects/*/memory/
• 格式： 带frontmatter的Markdown文件
• 类型： 用户偏好、反馈、项目上下文、参考
• 用途： 跨对话持久化的快速访问上下文
• 会话开始时自动加载

第3层：MCP记忆服务器（结构化知识图谱）

• 访问： MCP记忆工具（create_entities、create_relations、add_observations、search_nodes）
• 用途： 跨所有存储记忆的语义搜索、关系映射
• 具有可查询图结构的跨会话持久化

第4层：知识库仓库/持久文档存储

• 用途： 精选的持久笔记、会话导出、综合研究、操作员记忆、长文档
• 规则： 当内容不是仓库拥有的代码时，这是跨机器上下文的首选持久存储

第5层：外部数据存储（Supabase、PostgreSQL等）

• 用途： 结构化数据、大文档存储、全文搜索
• 适用于： 对记忆文件来说太大的文档、需要SQL查询的数据

第6层：本地context/archive文件夹

• 用途： 面向人类的笔记、归档的计划、本地媒体组织、临时非代码文档
• 规则： 可写入用于信息存储，但不是影子代码工作区
• 不用于： 应该存放在上游的活跃代码更改或仓库真相

摄取工作流程

当需要捕获新知识时：

1. 分类

这是什么类型的知识？

• 业务决策 -> 记忆文件（项目类型）+ MCP记忆
• 活跃路线图/发布/实施状态 -> 优先GitHub + Linear
• 个人偏好 -> 记忆文件（用户/反馈类型）
• 参考信息 -> 记忆文件（参考类型）+ MCP记忆
• 大文档 -> 外部数据存储 + 记忆中的摘要
• 对话/会话 -> 知识库仓库 + 简短摘要在记忆中

2. 去重

检查此知识是否已存在：

• 搜索记忆文件中的现有条目
• 使用相关术语查询MCP记忆
• 在创建另一个本地笔记之前，检查信息是否已存在于GitHub或Linear中
• 不要创建重复项。改为更新现有条目。

3. 存储

写入适当的层：

• 始终更新Claude Code记忆以便快速访问
• 使用MCP记忆实现语义可搜索性和关系映射
• 当信息改变实时项目真相时，优先更新GitHub/Linear
• 提交到知识库仓库用于持久的长文本添加

4. 索引

更新任何相关的索引或摘要文件。

同步操作

对话同步

定期将对话历史同步到知识库：

• 来源：Claude会话文件、Codex会话、其他Agent会话
• 目标：知识库仓库
• 生成会话索引以便快速浏览
• 提交并推送

工作区状态同步

将重要的工作区配置和脚本镜像到知识库：

• 生成目录映射
• 提交前编辑敏感配置
• 跟踪随时间的变化
• 不要将知识库或archive文件夹视为实时代码工作区

GitHub/Linear同步

当信息影响活跃执行时：

• 更新相关的GitHub issue、PR、讨论、发布说明或路线图线程
• 当工作需要持久规划上下文时，将支持文档附加到Linear
• 仅在信息不适合上游时镜像本地笔记