SuperAPI AI 工具集

cc-second-brain

智能体与模型

查看项目

更新于 10-16 04:24

技能介绍

用途

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 → 下次会话开始时一无所知;整合器可用的素材更少。

关于收费、价格、平台支持等具体信息,资料中暂未提供。