sumulige-claude 1.3.3 → 1.4.1

package/.claude/hooks/lib/fs-utils.cjs

@@ -0,0 +1,133 @@
+/**
+ * Hooks Shared Library - File System Utilities
+ *
+ * 带缓存的文件操作，减少重复读写
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 内存缓存
+const fileCache = new Map();
+const DEFAULT_TTL = 60000; // 1分钟
+
+/**
+ * 带缓存的 JSON 文件读取
+ */
+function readJsonCached(filePath, ttl = DEFAULT_TTL) {
+  const cached = fileCache.get(filePath);
+  const now = Date.now();
+
+  if (cached && now - cached.time < ttl) {
+    return cached.data;
+  }
+
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    fileCache.set(filePath, { data, time: now });
+    return data;
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 写入 JSON 文件并更新缓存
+ */
+function writeJsonCached(filePath, data) {
+  try {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+    fileCache.set(filePath, { data, time: Date.now() });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 带缓存的文本文件读取
+ */
+function readTextCached(filePath, ttl = DEFAULT_TTL) {
+  const cached = fileCache.get(filePath);
+  const now = Date.now();
+
+  if (cached && now - cached.time < ttl) {
+    return cached.data;
+  }
+
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    const data = fs.readFileSync(filePath, 'utf-8');
+    fileCache.set(filePath, { data, time: now });
+    return data;
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 清除缓存
+ */
+function clearCache(filePath = null) {
+  if (filePath) {
+    fileCache.delete(filePath);
+  } else {
+    fileCache.clear();
+  }
+}
+
+/**
+ * 确保目录存在
+ */
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+/**
+ * 安全文件操作 - 写入
+ */
+function safeWriteFile(filePath, content) {
+  try {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 安全文件操作 - 追加
+ */
+function safeAppendFile(filePath, content) {
+  try {
+    ensureDir(path.dirname(filePath));
+    fs.appendFileSync(filePath, content);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+module.exports = {
+  readJsonCached,
+  writeJsonCached,
+  readTextCached,
+  clearCache,
+  ensureDir,
+  safeWriteFile,
+  safeAppendFile
+};

package/.claude/hooks/rag-skill-loader.cjs

@@ -13,6 +13,10 @@ const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 const RAG_DIR = path.join(PROJECT_DIR, '.claude/rag');
 const SKILL_INDEX_FILE = path.join(RAG_DIR, 'skill-index.json');
 const SKILLS_DIR = path.join(PROJECT_DIR, '.claude/skills');
+const CACHE_FILE = path.join(RAG_DIR, '.match-cache.json');
+
+// 缓存配置
+const CACHE_TTL = 300000; // 5分钟缓存有效期
 
 // 技能关键词匹配权重
 const KEYWORD_WEIGHTS = {
@@ -21,6 +25,67 @@ const KEYWORD_WEIGHTS = {
   related: 0.5     // 相关匹配
 };
 
+// 简单哈希函数
+function hashInput(input) {
+  let hash = 0;
+  for (let i = 0; i < input.length; i++) {
+    const char = input.charCodeAt(i);
+    hash = ((hash << 5) - hash) + char;
+    hash = hash & hash;
+  }
+  return hash.toString(16);
+}
+
+// 加载缓存
+function loadCache() {
+  if (!fs.existsSync(CACHE_FILE)) {
+    return {};
+  }
+  try {
+    return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));
+  } catch (e) {
+    return {};
+  }
+}
+
+// 保存缓存
+function saveCache(cache) {
+  try {
+    // 清理过期条目
+    const now = Date.now();
+    const cleaned = {};
+    for (const [key, value] of Object.entries(cache)) {
+      if (now - value.timestamp < (value.ttl || CACHE_TTL)) {
+        cleaned[key] = value;
+      }
+    }
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cleaned, null, 2));
+  } catch (e) {
+    // 忽略保存错误
+  }
+}
+
+// 从缓存获取结果
+function getCachedResult(inputHash) {
+  const cache = loadCache();
+  const cached = cache[inputHash];
+  if (cached && Date.now() - cached.timestamp < (cached.ttl || CACHE_TTL)) {
+    return cached.result;
+  }
+  return null;
+}
+
+// 保存结果到缓存
+function setCachedResult(inputHash, result) {
+  const cache = loadCache();
+  cache[inputHash] = {
+    result,
+    timestamp: Date.now(),
+    ttl: CACHE_TTL
+  };
+  saveCache(cache);
+}
+
 // 加载技能索引
 function loadSkillIndex() {
   if (!fs.existsSync(SKILL_INDEX_FILE)) {
@@ -134,12 +199,27 @@ function main() {
       process.exit(0);
     }
 
-    const analysis = analyzeInput(toolInput);
-    if (analysis.keywords.length === 0) {
-      process.exit(0);
+    // 检查缓存
+    const inputHash = hashInput(toolInput);
+    const cachedResult = getCachedResult(inputHash);
+
+    let matches;
+    if (cachedResult) {
+      // 使用缓存结果
+      matches = cachedResult;
+    } else {
+      // 分析并匹配
+      const analysis = analyzeInput(toolInput);
+      if (analysis.keywords.length === 0) {
+        process.exit(0);
+      }
+
+      matches = matchSkills(analysis, skillIndex);
+
+      // 缓存结果
+      setCachedResult(inputHash, matches);
     }
 
-    const matches = matchSkills(analysis, skillIndex);
     if (matches.length === 0) {
       process.exit(0);
     }

package/.claude/settings.json

@@ -45,82 +45,23 @@
       "hooks": [
         {
           "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/project-kickoff.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/rag-skill-loader.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs",
-          "timeout": 1000
-        }
-      ]
-    }
-  ],
-  "PreToolUse": [
-    {
-      "matcher": {},
-      "hooks": [
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs",
-          "timeout": 1000
+          "command": "CLAUDE_EVENT_TYPE=UserPromptSubmit node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/hook-dispatcher.cjs",
+          "timeout": 3000
         }
       ]
     }
   ],
+  "PreToolUse": [],
   "PostToolUse": [
     {
-      "matcher": {},
+      "matcher": {
+        "tool_name": "^(Write|Edit)$"
+      },
       "hooks": [
         {
           "type": "command",
           "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/code-formatter.cjs",
           "timeout": 5000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/verify-work.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs",
-          "timeout": 1000
         }
       ]
     }
@@ -131,23 +72,8 @@
       "hooks": [
         {
           "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/verify-work.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs",
-          "timeout": 1000
-        },
-        {
-          "type": "command",
-          "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs",
-          "timeout": 1000
+          "command": "CLAUDE_EVENT_TYPE=AgentStop node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/hook-dispatcher.cjs",
+          "timeout": 3000
         }
       ]
     }

package/.claude/settings.local.json

@@ -132,7 +132,10 @@
       "Bash(/opt/homebrew/Cellar/node/25.3.0/bin/node:*)",
       "WebFetch(domain:docs.anthropic.com)",
       "Bash(CLAUDE_PROJECT_DIR=\"/Users/sumulige/Documents/Antigravity/sumulige-claude\" /opt/homebrew/Cellar/node/25.3.0/bin/node:*)",
-      "Bash(CLAUDE_PROJECT_DIR=\"/Users/sumulige/Documents/Antigravity/sumulige-claude\" /opt/homebrew/Cellar/node/25.3.0/bin/node .claude/hooks/memory-saver.cjs)"
+      "Bash(CLAUDE_PROJECT_DIR=\"/Users/sumulige/Documents/Antigravity/sumulige-claude\" /opt/homebrew/Cellar/node/25.3.0/bin/node .claude/hooks/memory-saver.cjs)",
+      "Bash(du:*)",
+      "Bash(wc:*)",
+      "Bash(/Users/sumulige/.local/share/fnm/node-versions/v24.3.0/installation/bin/node /Users/sumulige/.local/share/fnm/node-versions/v24.3.0/installation/lib/node_modules/npm/bin/npm-cli.js test)"
     ]
   },
   "hooks": {

package/CHANGELOG.md

@@ -1,3 +1,135 @@
+## [1.4.1](https://github.com/sumulige/sumulige-claude/compare/v1.4.0...v1.4.1) (2026-01-23)
+
+### 💡 契机
+
+在将 sumulige-claude 配置同步到多个项目时，发现每次更新后需要手动复制 hooks/skills/templates/commands 到各项目的 `.claude/` 目录，维护成本高且容易出现配置漂移。
+
+**问题**：
+- 14 个项目各自维护 `.claude/` 副本
+- 更新 sumulige-claude 后需要逐个同步
+- 项目间配置不一致
+
+**解决方案**：利用 Claude Code 的全局配置继承机制，实现单一真相源。
+
+### 🏗️ 架构优化：配置分层继承
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│           sumulige-claude/.claude/ (Git 仓库 - 版本控制)         │
+│  hooks/ ─────────────────────────────────────────────────────── │
+│  skills/ ────────────────────────────────────────────────────── │  符号链接
+│  templates/ ─────────────────────────────────────────────────── │     ↓
+│  commands/ ──────────────────────────────────────────────────── │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                    ~/.claude/ (运行时)                          │
+│  hooks/ → symlink to sumulige-claude                            │
+│  skills/ → symlink to sumulige-claude                           │
+│  templates/ → symlink to sumulige-claude                        │
+│  commands/ → symlink to sumulige-claude                         │
+│  + 运行时数据 (cache, debug, history.jsonl...)                   │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 自动继承
+┌─────────────────────────────────────────────────────────────────┐
+│                    项目/.claude/ (仅项目特定内容)                │
+│  MEMORY.md, PROJECT_LOG.md, ANCHORS.md, CLAUDE.md              │
+│  thinking-routes/, rag/                                         │
+│  ❌ 不再需要: hooks/, skills/, templates/, commands/            │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### ✨ 新增
+
+- **`scripts/sync-to-home.sh`**: 符号链接同步脚本
+  ```bash
+  ./scripts/sync-to-home.sh          # 完整同步（链接 + 复制模板）
+  ./scripts/sync-to-home.sh --link   # 仅建立符号链接
+  ./scripts/sync-to-home.sh --copy   # 仅复制模板文件
+  ./scripts/sync-to-home.sh --status # 查看当前状态
+  ```
+
+- **`.claude/skills/template/`**: Skill 创建模板目录
+
+### 🧹 清理
+
+| 删除 | 原因 |
+|------|------|
+| `.claude/backup/` | 空目录 |
+| `.claude/verify/` | 空目录 |
+| `.claude/sessions/*.json` | 运行时数据 |
+| 测试 skills (api-tester, my-skill...) | 测试数据 |
+
+### 📚 文档更新
+
+- **CLAUDE.md**: 更新受保护目录说明，添加全局继承注意事项
+- **MEMORY.md**: 重置为空模板
+
+### 🎯 收益
+
+| 指标 | 之前 | 之后 |
+|------|------|------|
+| 项目 `.claude/` 文件数 | ~300 个 | ~10 个 |
+| 更新配置需同步项目数 | 14 个 | 0 个 (自动) |
+| 配置漂移风险 | 高 | 零 |
+
+---
+
+## [1.4.0](https://github.com/sumulige/sumulige-claude/compare/v1.3.3...v1.4.0) (2026-01-23)
+
+### 🚀 架构优化 (Token 成本降低 62%)
+
+#### 新增文件 (10 个)
+
+| 文件 | 用途 |
+|------|------|
+| `hook-dispatcher.cjs` | 统一 Hook 调度器，支持 debounce 和条件执行 |
+| `hook-registry.json` | Hook 配置注册表 |
+| `hooks/lib/fs-utils.cjs` | 共享文件操作库 |
+| `hooks/lib/cache.cjs` | 缓存工具类 |
+| `version-manifest.json` | 版本兼容性矩阵 |
+| `lib/version-manifest.js` | 版本管理库 |
+| `lib/incremental-sync.js` | 增量同步实现 |
+| `commands/workflow.md` | /workflow 统一命令 |
+
+#### 精简内容
+
+| 项目 | 之前 | 之后 | 变化 |
+|------|------|------|------|
+| `PreToolUse` hooks | 3 个 | 0 个 | **清空** |
+| `PostToolUse` hooks | 5 个 | 1 个 | **-80%** |
+| `UserPromptSubmit` hooks | 5 个 | 1 个 | **-80%** |
+| `AgentStop` hooks | 4 个 | 1 个 | **-75%** |
+| `settings.json` 行数 | 155 行 | 81 行 | **-48%** |
+
+#### 性能提升
+
+| 指标 | 优化前 | 优化后 | 提升 |
+|------|--------|--------|------|
+| Hook 调用次数/tool call | 12+ 次 | 2-3 次 | **-75%** |
+| RAG 匹配 | O(n×m) | O(1) 缓存 | **显著** |
+| PostToolUse 开销 | 每次 5 hooks | 仅 Write/Edit | **-90%+** |
+
+### ✨ New Features
+
+- **`smc sync --incremental`**: 增量同步，只更新变更文件
+- **`/workflow` 命令**: 统一工作流
+  - `/workflow check` - 检查更新状态
+  - `/workflow pull` - 增量同步
+  - `/workflow full` - 一键完整流程
+- **Hook 智能调度**: debounce、runOnce、条件执行
+- **RAG 缓存**: 5 分钟 TTL，避免重复匹配
+- **版本追踪**: 自动检测 breaking changes
+
+### 🧪 Tests
+
+```
+Test Suites: 15 passed, 15 total
+Tests:       575 passed, 575 total
+```
+
+---
+
 ## [1.3.3](https://github.com/sumulige/sumulige-claude/compare/v1.3.2...v1.3.3) (2026-01-22)
 
 ### ✨ New Features

package/README.md

@@ -16,7 +16,10 @@
 4. [Layer 4: Quick Start / 第四层：快速开始](#layer-4-quick-start--第四层快速开始)
 5. [Layer 5: Commands / 第五层：命令参考](#layer-5-commands--第五层命令参考)
 6. [Layer 6: Advanced / 第六层：高级配置](#layer-6-advanced--第六层高级配置)
-7. [Documentation / 文档](#documentation--文档)
+7. [Layer 7: Lifecycle Hooks / 第七层：生命周期钩子](#layer-7-lifecycle-hooks--第七层生命周期钩子)
+8. [Layer 8: Data Flow Architecture / 第八层：数据流转架构](#layer-8-data-flow-architecture--第八层数据流转架构)
+9. [Layer 9: Config Inheritance / 第九层：配置分层继承](#layer-9-config-inheritance--第九层配置分层继承)
+10. [Documentation / 文档](#documentation--文档)
 
 ---
 
@@ -462,6 +465,162 @@ smc template
 
 ---
 
+## Layer 8: Data Flow Architecture / 第八层：数据流转架构
+
+> v1.4.0: Hook 统一调度 + 智能过滤，Token 成本降低 62%
+
+### Hook 调度流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           Claude Code 事件触发                            │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         settings.json 路由                               │
+├─────────────────────────────────────────────────────────────────────────┤
+│  SessionStart  ──────→ memory-loader.cjs (直接执行)                      │
+│  SessionEnd    ──────→ memory-saver.cjs (直接执行)                       │
+│  PreCompact    ──────→ auto-handoff.cjs (直接执行)                       │
+│  UserPromptSubmit ───→ hook-dispatcher.cjs                              │
+│  PreToolUse    ──────→ (空，不执行任何 hook)                              │
+│  PostToolUse   ──────→ code-formatter.cjs (仅 Write/Edit 时)            │
+│  AgentStop     ──────→ hook-dispatcher.cjs                              │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### Hook Dispatcher 内部流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                      hook-dispatcher.cjs                                 │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+                    ┌───────────────┼───────────────┐
+                    ▼               ▼               ▼
+            ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
+            │ 加载 Registry│ │  加载 State │ │ 获取事件类型 │
+            │ hook-registry│ │ .dispatcher │ │CLAUDE_EVENT │
+            │    .json    │ │ -state.json │ │   _TYPE     │
+            └─────────────┘ └─────────────┘ └─────────────┘
+                    │               │               │
+                    └───────────────┼───────────────┘
+                                    ▼
+                    ┌───────────────────────────────┐
+                    │      筛选当前事件的 Hooks      │
+                    └───────────────────────────────┘
+                                    │
+                                    ▼
+            ┌───────────────────────────────────────────────┐
+            │              对每个 Hook 检查                  │
+            ├───────────────────────────────────────────────┤
+            │  1. shouldRunDebounce() - 5秒内执行过? → 跳过  │
+            │  2. shouldRunOnce() - 已执行过? → 跳过         │
+            │  3. shouldRunCondition() - 条件不满足? → 跳过  │
+            └───────────────────────────────────────────────┘
+                                    │
+                                    ▼
+                    ┌───────────────────────────────┐
+                    │   执行通过检查的 Hook + 更新状态 │
+                    └───────────────────────────────┘
+```
+
+### 增量同步流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    smc sync --incremental                                │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+        ┌───────────────────────────┼───────────────────────────┐
+        ▼                           ▼                           ▼
+┌───────────────┐         ┌───────────────┐         ┌───────────────┐
+│ 读取项目版本   │         │ 读取版本清单   │         │  计算差异变更  │
+│ .sumulige-    │         │ version-      │         │ getChangesSince│
+│ claude-version│         │ manifest.json │         │   (1.3.3)     │
+└───────────────┘         └───────────────┘         └───────────────┘
+                                    │
+                                    ▼
+            ┌───────────────────────────────────────────────┐
+            │  应用变更: hook/config/lib/command            │
+            │  更新项目版本标记                              │
+            └───────────────────────────────────────────────┘
+```
+
+### 状态文件汇总
+
+| 文件 | 用途 | 生命周期 |
+|------|------|----------|
+| `.dispatcher-state.json` | Hook 执行状态 | 会话级 |
+| `.match-cache.json` | RAG 匹配缓存 | 5 分钟 TTL |
+| `.sumulige-claude-version` | 项目版本标记 | 永久 |
+
+---
+
+## Layer 9: Config Inheritance / 第九层：配置分层继承
+
+> v1.4.1: 单一真相源架构，零维护成本的多项目配置管理
+
+### 架构图
+
+```
+sumulige-claude/.claude/          ~/.claude/              项目/.claude/
+(Git 仓库 - 版本控制)             (运行时 - 符号链接)      (项目特定)
+        │                              │                       │
+        ├── hooks/ ─────→ symlink ────→│                       │
+        ├── skills/ ────→ symlink ────→│        自动继承       │
+        ├── templates/ ─→ symlink ────→│ ─────────────────────→│
+        ├── commands/ ──→ symlink ────→│                       │
+        │                              │                       │
+        └── *.md ────────→ 复制 ──────→│                       │
+                                       │                       │
+                                       ├── cache/              ├── MEMORY.md
+                                       ├── debug/              ├── PROJECT_LOG.md
+                                       └── history.jsonl       └── thinking-routes/
+```
+
+### 使用方式
+
+```bash
+# 首次设置：建立符号链接
+cd ~/Documents/Antigravity/sumulige-claude
+./scripts/sync-to-home.sh
+
+# 日常更新：修改 sumulige-claude 后自动生效
+git pull  # 所有项目自动获得最新配置！
+
+# 更新模板文件（CLAUDE.md, MEMORY.md 等）
+./scripts/sync-to-home.sh --copy
+```
+
+### 项目配置精简
+
+**之前**：每个项目复制完整 `.claude/` (~300 个文件)
+
+**之后**：项目只保留特定内容 (~10 个文件)
+
+```
+项目/.claude/
+├── MEMORY.md           # 项目记忆
+├── PROJECT_LOG.md      # 项目日志
+├── ANCHORS.md          # 项目锚点
+├── CLAUDE.md           # 项目配置 (继承+覆盖)
+├── thinking-routes/    # 思维轨迹
+└── rag/                # 项目 RAG 索引
+```
+
+### 收益
+
+| 指标 | 传统方式 | 分层继承 |
+|------|---------|---------|
+| 配置同步 | 手动复制到每个项目 | 自动（符号链接） |
+| 更新成本 | O(n) 项目数 | O(1) |
+| 配置漂移 | 容易发生 | 不可能 |
+| 存储空间 | 每项目 ~5MB | 每项目 ~50KB |
+
+---
+
 ## Documentation / 文档
 
 - **[Development Guide / 开发指南](docs/DEVELOPMENT.md)** - Architecture, adding skills / 架构、添加技能