用途
cc-second-brain 用于管理 Claude Code 配置的三层记忆系统,由 engram(工作记忆)、Obsidian vault(持久记忆)和插件规则(基线规则)组成。其目标是在 conventions.md 和 topic-key-taxonomy.md 中实现完整的关注点分离。
主要能力
三层路由决策树
工作结束后,按以下决策树判断信息归属:
- 是否为一次性观察、决策或发现?是 → engram(第 1 层),使用带 CC topic_key 的 mem_save(参见分类法)。
- 是否为可复用模式(在 ≥ 2 个仓库中使用过或有用)?是 → Obsidian(第 2 层),路径为 Research/Claude-Code/Patterns/{slug}.md;若为用户策展,frontmatter 中 auto_generated: false。
- 是否为仓库专属的持久知识?是 → Obsidian(第 2 层),路径为 Repositories/{org}/{repo}.md,或 Decisions/NNNN-title.md(用于 ADR)。
- 是否为每个消费仓库的 Claude 都应遵循的规则?是 → 插件规则(第 3 层),路径为 memory/rules/cc-always.md(仅插件维护者可编辑)。
Engram(第 1 层)写入模式
调用 mem_save 并带 CC topic_key。完整前缀表见 topic-key-taxonomy.md。
必需:title、content(What/Why/Where/Learned 格式)。 推荐:以 cc/* 开头的 topic_key、type(decision/bugfix/architecture/discovery/pattern/config/preference)、scope(project 或 personal)。
示例:
mem_save({ title: "Chose protect-sensitive-files hook for all new setups", type: "decision", topic_key: "cc/hooks/protect-sensitive-files", content: "What: Default install on every /cc-setup run\nWhy: Prevents writes to .env / credentials / keys\nWhere: memory/rules/cc-always.md\nLearned: Hook matcher Write|Edit is correct — don't also match MultiEdit, it inherits" })
Obsidian(第 2 层)写入模式
优先:若已加载 Obsidian MCP 工具(mcp__obsidian__*),使用它们通过 Local REST API 追加/更新。
回退:在 vault 路径直接使用 Write 工具。
自动生成笔记的 frontmatter(仅整合器使用):
auto_generated: true source: engram topic_key: cc/patterns/{slug} reinforcement_count: 7 first_seen: 2026-04-09 last_updated: 2026-04-16 tags: [claude-code, pattern, auto]
用户策展笔记的 frontmatter:
title: {short title} created: {YYYY-MM-DD} tags: [claude-code, type/pattern]
持久性不变式:没有 auto_generated: true 的笔记即为用户策展,整合器永不覆盖。若代表用户写入笔记,请显式使用 auto_generated: false。
插件规则(第 3 层)写入模式
- memory/rules/cc-always.md — 仅用户可编辑(通过 /cc-memory edit-always)。
- memory/rules/cc-patterns.md — 仅整合器可编辑。
- memory/rules/DRAFT.md — 仅整合器可编辑(冲突)。
请勿手动编辑 cc-patterns.md 或 DRAFT.md — 它们归整合器所有。
使用方式
查询各层
- “我们之前解决过这个问题吗?” → mem_search 带 cc/ 前缀提示 → mem_context 获取近期历史。
- “X 的当前规则是什么?” → 读取 memory/rules/cc-always.md 和 memory/rules/cc-patterns.md。
- “Y 存在哪些模式?” → Obsidian MCP 搜索或对 Research/Claude-Code/Patterns/ 执行 Grep。
- “这个仓库知道什么?” → 先读取 Repositories/{org}/{repo}.md。
/cc-memory 子命令
- search <query>:engram mem_search,范围限定为 cc/* 键。
- export [--domain ...]:将人类可读摘要写入 memory/digests/{date}.md。
- consolidate:运行整合器:engram → Obsidian + cc-patterns.md。
- edit-always:打开 memory/rules/cc-always.md。
- review:打开 memory/rules/DRAFT.md(冲突)。
- status:显示上次整合、模式数量、草稿数量、cc/* 观察数量。
整合器使用的 MCP 工具(对 engram 只读)
- mem_search:查找 cc/* 观察。
- mem_get_observation:获取匹配项的完整内容。
- mem_context:用于时序判断的近期会话上下文。
整合器绝不使用:mem_save、mem_update、mem_delete。这些仅限会话中的 Claude 或用户手动操作。
适用场景
适用于使用 Claude Code 并希望系统化沉淀配置经验的用户,尤其是需要区分一次性观察、可复用模式、仓库专属知识和全局规则,并在多个仓库间复用配置模式的场景。
限制与常见反模式
- 为 CC 工作保存到 engram 时未带 topic_key → 整合器无法分组观察 → 模式永不提升。
- 向 Repositories/{org}/{repo}.md 写入时,实际为手工策展却标记 auto_generated: true → 整合器稍后会覆盖它。
- 手动编辑 memory/rules/cc-patterns.md → 整合器下次运行会覆盖你的编辑。请将手工策展放入 cc-always.md。
- 会话结束时跳过 mem_session_summary → 下次会话开始时一无所知;整合器可用的素材更少。
关于收费、价格、平台支持等具体信息,资料中暂未提供。