知识沉淀与记忆——Repo Wiki、知识引擎、任务记忆
为什么知识沉淀重要
第一次让 Agent 处理你的项目时,它需要从零理解——读代码、看目录结构、猜测设计意图。每次新会话都是冷启动。
知识沉淀的目标是 让 Agent 越用越懂你的项目:
- 自动生成项目文档(Repo Wiki);
- 沉淀任务经验(下次遇到类似任务更快);
- 记住你的偏好和项目约定。
Repo Wiki
Repo Wiki 是 Qoder 的 自动文档生成能力:
- Agent 读取你的代码库结构;
- 分析模块职责、依赖关系、关键类和方法;
- 自动生成一份结构化的项目文档;
- 代码变更时持续追踪并更新。
Repo Wiki 能做什么
- 快速上手:新团队成员看 Repo Wiki 就知道项目架构,不需要反复问人。
- 知识留存:项目核心人员离职时,知识不会跟着走。
- Agent 更懂你:后续 Agent 任务会自动参考 Repo Wiki 的内容,理解更准确。
实际效果
高德汽车业务团队反馈:引入 Repo Wiki 后,新成员上手时间从几周缩短到几小时——Agent 在任务执行时自动参考 Wiki 内容,减少了反复的澄清和错误。
知识引擎
知识引擎是 Qoder 的核心能力模块,负责自动沉淀和管理你在日常开发中产生的业务知识:
- 从你和 Agent 的对话中提取知识片段;
- 按主题归档,形成 知识卡片;
- 后续 Agent 任务自动检索相关知识卡片作为上下文。
知识卡片
知识卡片是结构化的知识片段:
- 什么问题、什么场景下用过什么方案;
- 踩过什么坑、怎么绕过的;
- 团队内部的约定和最佳实践。
知识引擎 vs Repo Wiki
| 维度 | Repo Wiki | 知识引擎 |
|---|---|---|
| 来源 | 代码库静态分析 | 对话、任务执行过程 |
| 内容 | 项目架构、模块职责、API 文档 | 业务知识、踩坑经验、团队约定 |
| 更新方式 | 代码变更时自动追踪 | 每次对话和任务后自动沉淀 |
| 消费方 | 人 + Agent | Agent(自动检索作为上下文) |
任务记忆
任务记忆是 Agent 跨任务保留 的信息:
- 你在某次任务中对命名风格的偏好;
- 某次对话中你说「以后这个模块都用 PageHelper 分页」;
- 你在某次澄清里给出的关于业务的解释。
这些记忆会在后续任务中自动作为 Agent 的上下文——你不需要每次都重新说明。
记忆的边界
- 记忆是跨会话的,但只在同一账号、同一项目范围内。
- 记忆会过期或被清理,如果发现 Agent 引用了过时的记忆,可以手动清除。
- 记忆不会上传到云端分享——是你本地/专属的上下文。
团队知识共享
团队版(企业版)可以把 Repo Wiki 和知识卡片 在团队内共享:
- 所有人的 Agent 都能利用团队沉淀的知识;
- 新人进来就能看到之前的踩坑记录和最佳实践;
- 知识资产变成团队共享的资源。
和 Skills / 自定义智能体的关系
知识沉淀是 被动自动 的——你正常对话、正常跑任务就行。
如果想 主动沉淀可复用的工作流,可以用 Skills 或创建自定义智能体:
- Skills:把一套可重复的工作方法封装成技能,下次一键调用。
- 自定义智能体:创建有特定角色、工具权限和系统提示词的 AI Agent。
下一步
- 想创建自己的 Skills / 自定义智能体 → JetBrains 插件
- 知识用完了、Credits 不够了 → Credits 用量管理