---
title: "KB 借鉴 Opus 设计：轻量索引 + prefs/projects + decisions 开张"
created: 2026-08-01
updated: 2026-08-01
tags: [tech/kb, tech/agent]
---

# KB 借鉴 Opus 设计：轻量索引 + prefs/projects + decisions 开张

- Date: 2026-08-01
- Context: Claude Opus 给大哥设计了多 Agent 共享 kb（facts/prefs/projects/refs/docs/journal + AGENTS.md 自动索引）。与本地 ~/Code/kb 逐条对比后评估取舍。
- Options considered:
  1. **整体迁移到 Opus 结构** — agent 直写无审查、one fact per file、AGENTS.md 做入口。缺点：丢掉 ingest 管道（raw 2900+ 文件）+ 人类筛选 gate，知识库会膨胀成垃圾场。
  2. **保持现有架构，只借鉴 3 处** — 轻量索引、prefs/ + projects/ 目录、decisions 落盘。缺点：多 Agent 共享能力仍有限。
  3. 不动 — 缺点：wiki 膨胀后 agent 发现性差，偏好只活在 Hermes memory 里。
- Decision: 选项 2。新增 `scripts/reindex.sh` 生成 `wiki/INDEX.md`；建 `prefs/`、`projects/`；`decisions/` 开张。
- Rationale: 现有 raw→wiki + 人类筛选是核心优势，不能丢；索引解决发现性问题；prefs/projects 让偏好与项目状态脱离 Hermes 私有 memory，多工具可读。**不照搬**：agent 直写、one-fact-per-file、CLAUDE.md symlink hack。
- Outcome: 2026-08-01 实施完毕，INDEX.md 已生成。
