从 Agent 会话中提取知识,提炼到情景/语义/程式三层记忆。当用户执行 /refine-knowledge 或检测到未处理的会话摘要时触发。
知识提炼管线:Working → Episodic → Procedural/Semantic。
用户输入 /refine-knowledge 时触发,或 Agent 检测到 04-Working/ 下有未处理的 agent-session/ 目录时主动提醒用户。
本 skill 管理的 vault 以五层认知架构为组织原则:
| 层级 | 核心问题 | 对应目录 | Agent 行为 |
|---|---|---|---|
| L5 Identity | 我是谁? | 00-Identity/ | 主动读取 + 自动检测信号,提案制更新 |
| L4 Procedural | 我怎么做? | 01-Procedural/ | 读取作行为参考,新建无需确认,修改需确认 |
| L3 Semantic | 我知道什么? | 02-Semantic/ | 自由读写,不确定时优先 Resources |
| L2 Episodic | 发生过什么? | 03-Episodic/ | 自由写入 |
| L1 Working |
| 当前在做什么? |
04-Working/ |
| 自由读写 |
输出层 05-Creation/ 和归档 06-Archive/ 不属于认知层。
L3 Semantic 内部使用 Areas/Resources 分类。信息在各层之间流动遵循[[知识生命周期]]。
Identity 层由以下文件组成,Agent 应主动读取以理解用户身份和工作方式:
| 文件 | 内容 | 读取时机 |
|---|---|---|
profile.md | 核心身份卡 — 自我概念、活跃关注领域、当前角色 | 会话启动时 |
values/core-values.md | 核心价值观和行为原则 | 涉及决策时 |
capabilities/current-skills.md | 当前技能矩阵和短板 | 涉及技术选型时 |
capabilities/growth-trajectory.md | 能力演进轨迹 | 涉及成长方向时 |
preferences/work-style.md | 工作偏好(时间、协作、学习) | 涉及工作方式时 |
relationships/communities.md | 所属社群和组织 | 涉及社交场景时 |
narrative/turning-points.md | 塑造身份的关键事件 | 涉及身份变化时 |
文件夹名是内容主题名(LangChain/),不是形式名/活动名(langchain学习/)。
文件跟着归属走,不跟着使用场景走。笔记不因被 Working 中的任务使用而搬家。
本 vault 的核心目标是构建用户的数字分身:
身份决定采用什么方法,方法的实践结果沉淀为 Procedural,有效的方法强化身份认知。这是一个持续演进的闭环。
04-Working/ ← L1 当前工作
├── YYYY-MM-DD/
│ └── agent-session/
│ └── {任务名}.md ← 会话摘要(processed: false = 未处理)
03-Episodic/ ← L2 情景记忆
02-Semantic/ ← L3 结构化知识
01-Procedural/ ← L4 已验证方法
00-Identity/ ← L5 身份认知
06-Archive/ ← 归档与摄取
激活时读取 ~/.claude/second-brain/.vault-config.json,获取 vaultPath、initialized、hooksMounted 三个字段。
Vault 路径确认 — 从 .vault-config.json 读取 vaultPath(如果存在)。首次使用无配置时,询问用户 vault 路径(默认:~/Documents/SecondBrain),用户确认后执行:
second-brain-cli init-vault <vault-path>
脚本创建目录结构、生成模板、更新 ~/.claude/second-brain/.vault-config.json 中 initialized: true 和 vaultPath
自动挂载 Hooks — 检查 .vault-config.json 中 hooksMounted 是否为 true。未挂载时自动执行:
second-brain-cli mount-hooks
脚本更新 ~/.claude/settings.json,设置 ~/.claude/second-brain/.vault-config.json 中 hooksMounted: true
无需用户确认:这是 Skill 正常运行所必需的基础配置,
npx skills add不会自动注册 hooks。
向用户报告初始化完成(Vault 路径、Hooks 状态)
详细步骤:
references/pipeline.mdreferences/criteria.mdreferences/vault-templates/ 中对应模板的 HTML 注释references/vault-templates/references/session-summary-template.md任务进度:
- [ ] Step 1: 扫描未处理会话(列列表给用户确认)
- [ ] Step 2: 提炼 Episodic
- [ ] Step 2.5: 检测 Identity 信号(生成提案)
- [ ] Step 3: 检测模式 → 提议 Procedural/Semantic(用户确认)
- [ ] Step 4: 更新所有索引
- [ ] 向用户报告结果