sumulige-claude 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -1,3 +1,80 @@
+## [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%)

package/README.md

@@ -18,7 +18,8 @@
 6. [Layer 6: Advanced / 第六层：高级配置](#layer-6-advanced--第六层高级配置)
 7. [Layer 7: Lifecycle Hooks / 第七层：生命周期钩子](#layer-7-lifecycle-hooks--第七层生命周期钩子)
 8. [Layer 8: Data Flow Architecture / 第八层：数据流转架构](#layer-8-data-flow-architecture--第八层数据流转架构)
-9. [Documentation / 文档](#documentation--文档)
+9. [Layer 9: Config Inheritance / 第九层：配置分层继承](#layer-9-config-inheritance--第九层配置分层继承)
+10. [Documentation / 文档](#documentation--文档)
 
 ---
 
@@ -557,6 +558,69 @@ smc template
 
 ---
 
+## 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 / 架构、添加技能

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sumulige-claude",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "The Best Agent Harness for Claude Code",
   "main": "cli.js",
   "bin": {

package/scripts/sync-to-home.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# sumulige-claude → ~/.claude 同步脚本
+# 用法: ./scripts/sync-to-home.sh [--link | --copy]
+
+set -e
+
+SOURCE_DIR="$(cd "$(dirname "$0")/.." && pwd)/.claude"
+TARGET_DIR="$HOME/.claude"
+
+# 颜色
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo "═══════════════════════════════════════════════════════════"
+echo "  sumulige-claude → ~/.claude 同步"
+echo "═══════════════════════════════════════════════════════════"
+echo ""
+echo "源目录: $SOURCE_DIR"
+echo "目标: $TARGET_DIR"
+echo ""
+
+# 需要符号链接的目录（共享配置）
+LINK_DIRS=(hooks skills templates commands)
+
+# 需要复制的文件（模板）
+COPY_FILES=(
+    CLAUDE.md
+    MEMORY.md
+    PROJECT_LOG.md
+    ANCHORS.md
+    AGENTS.md
+    README.md
+    boris-optimizations.md
+    settings.json
+)
+
+# 创建符号链接
+sync_links() {
+    echo "📁 同步共享配置 (符号链接)..."
+    for dir in "${LINK_DIRS[@]}"; do
+        if [ -d "$SOURCE_DIR/$dir" ]; then
+            # 删除目标目录（如果存在且不是链接）
+            if [ -d "$TARGET_DIR/$dir" ] && [ ! -L "$TARGET_DIR/$dir" ]; then
+                echo "  删除现有目录: $TARGET_DIR/$dir"
+                rm -rf "$TARGET_DIR/$dir"
+            fi
+            # 创建符号链接
+            if [ ! -L "$TARGET_DIR/$dir" ]; then
+                ln -sf "$SOURCE_DIR/$dir" "$TARGET_DIR/$dir"
+                echo -e "  ${GREEN}✓${NC} $dir → 已链接"
+            else
+                echo -e "  ${YELLOW}○${NC} $dir → 已是链接"
+            fi
+        fi
+    done
+}
+
+# 复制模板文件
+sync_files() {
+    echo ""
+    echo "📄 同步模板文件 (复制)..."
+    for file in "${COPY_FILES[@]}"; do
+        if [ -f "$SOURCE_DIR/$file" ]; then
+            cp "$SOURCE_DIR/$file" "$TARGET_DIR/$file"
+            echo -e "  ${GREEN}✓${NC} $file"
+        fi
+    done
+}
+
+# 显示状态
+show_status() {
+    echo ""
+    echo "═══════════════════════════════════════════════════════════"
+    echo "  当前状态"
+    echo "═══════════════════════════════════════════════════════════"
+    for dir in "${LINK_DIRS[@]}"; do
+        if [ -L "$TARGET_DIR/$dir" ]; then
+            target=$(readlink "$TARGET_DIR/$dir")
+            echo -e "  ${GREEN}✓${NC} $dir → $target"
+        elif [ -d "$TARGET_DIR/$dir" ]; then
+            echo -e "  ${YELLOW}○${NC} $dir (独立目录，未链接)"
+        else
+            echo "  ✗ $dir (不存在)"
+        fi
+    done
+}
+
+# 主逻辑
+case "${1:-}" in
+    --status)
+        show_status
+        ;;
+    --link)
+        sync_links
+        show_status
+        ;;
+    --copy)
+        sync_files
+        ;;
+    *)
+        sync_links
+        sync_files
+        echo ""
+        echo -e "${GREEN}✅ 同步完成！${NC}"
+        show_status
+        ;;
+esac

package/.claude/sessions/active-sessions.json

@@ -1 +0,0 @@
-[]

package/.claude/sessions/session_2026-01-22T13-07-26-625Z.json

@@ -1,23 +0,0 @@
-{
-  "session": {
-    "id": "unknown",
-    "startTime": "2026-01-22T13:06:23.872Z",
-    "project": "sumulige-claude",
-    "version": "1.3.1"
-  },
-  "memory": {
-    "loaded": true,
-    "entries": 4
-  },
-  "anchors": {
-    "loaded": true,
-    "modules": 0
-  },
-  "todos": {
-    "loaded": true,
-    "active": 0,
-    "completed": 0
-  },
-  "endTime": "2026-01-22T13:07:26.625Z",
-  "duration": "1 minutes"
-}

package/.claude/skills/api-tester/SKILL.md

@@ -1,61 +0,0 @@
-# Api Tester
-
-> 简短描述这个技能的作用（一句话）
-
-**版本**: 1.0.0
-**作者**: @username
-**标签**: [category1, category2]
-**难度**: 初级/中级/高级
-
----
-
-## 概述
-
-详细描述这个技能的功能和用途。
-
-## 适用场景
-
-- 场景 1
-- 场景 2
-- 场景 3
-
-## 触发关键词
-
-```
-keyword1, keyword2, "exact phrase"
-```
-
-## 使用方法
-
-### 基础用法
-
-```bash
-# 示例命令
-your-command-here
-```
-
-### 高级用法
-
-```yaml
-# 配置示例
-key: value
-```
-
-## 输出格式
-
-描述这个技能的输出结果格式。
-
-## 注意事项
-
-- 注意事项 1
-- 注意事项 2
-
-## 相关技能
-
-- [related-skill](../related-skill/)
-- [another-skill](../another-skill/)
-
-## 更新日志
-
-### 1.0.0 (YYYY-MM-DD)
-- 初始版本

package/.claude/skills/api-tester/examples/basic.md

@@ -1,3 +0,0 @@
-# Basic Example for api-tester
-
-Replace this with your actual example.

package/.claude/skills/api-tester/metadata.yaml

@@ -1,30 +0,0 @@
-# Skill Metadata
-# 这个文件定义技能的基本信息，用于自动发现和索引
-
-name: api-tester
-version: 1.0.0
-author: @username
-description: 简短描述技能功能
-
-tags:
-  - category1
-  - category2
-
-triggers:
-  - keyword1
-  - keyword2
-  - "exact phrase"
-
-dependencies: []  # 依赖的其他技能
-
-difficulty: beginner  # beginner | intermediate | advanced
-
-# 模板文件
-templates:
-  - name: default
-    file: templates/default.md
-
-# 示例文件
-examples:
-  - name: basic
-    file: examples/basic.md

package/.claude/skills/api-tester/templates/default.md

@@ -1,3 +0,0 @@
-# Default Template for api-tester
-
-Replace this with your actual template.

package/.claude/skills/code-reviewer-123/SKILL.md

@@ -1,61 +0,0 @@
-# Code Reviewer 123
-
-> 简短描述这个技能的作用（一句话）
-
-**版本**: 1.0.0
-**作者**: @username
-**标签**: [category1, category2]
-**难度**: 初级/中级/高级
-
----
-
-## 概述
-
-详细描述这个技能的功能和用途。
-
-## 适用场景
-
-- 场景 1
-- 场景 2
-- 场景 3
-
-## 触发关键词
-
-```
-keyword1, keyword2, "exact phrase"
-```
-
-## 使用方法
-
-### 基础用法
-
-```bash
-# 示例命令
-your-command-here
-```
-
-### 高级用法
-
-```yaml
-# 配置示例
-key: value
-```
-
-## 输出格式
-
-描述这个技能的输出结果格式。
-
-## 注意事项
-
-- 注意事项 1
-- 注意事项 2
-
-## 相关技能
-
-- [related-skill](../related-skill/)
-- [another-skill](../another-skill/)
-
-## 更新日志
-
-### 1.0.0 (YYYY-MM-DD)
-- 初始版本

package/.claude/skills/code-reviewer-123/examples/basic.md

@@ -1,3 +0,0 @@
-# Basic Example for code-reviewer-123
-
-Replace this with your actual example.

package/.claude/skills/code-reviewer-123/metadata.yaml

@@ -1,30 +0,0 @@
-# Skill Metadata
-# 这个文件定义技能的基本信息，用于自动发现和索引
-
-name: code-reviewer-123
-version: 1.0.0
-author: @username
-description: 简短描述技能功能
-
-tags:
-  - category1
-  - category2
-
-triggers:
-  - keyword1
-  - keyword2
-  - "exact phrase"
-
-dependencies: []  # 依赖的其他技能
-
-difficulty: beginner  # beginner | intermediate | advanced
-
-# 模板文件
-templates:
-  - name: default
-    file: templates/default.md
-
-# 示例文件
-examples:
-  - name: basic
-    file: examples/basic.md

package/.claude/skills/code-reviewer-123/templates/default.md

@@ -1,3 +0,0 @@
-# Default Template for code-reviewer-123
-
-Replace this with your actual template.

package/.claude/skills/my-skill/SKILL.md

@@ -1,61 +0,0 @@
-# My Skill
-
-> 简短描述这个技能的作用（一句话）
-
-**版本**: 1.0.0
-**作者**: @username
-**标签**: [category1, category2]
-**难度**: 初级/中级/高级
-
----
-
-## 概述
-
-详细描述这个技能的功能和用途。
-
-## 适用场景
-
-- 场景 1
-- 场景 2
-- 场景 3
-
-## 触发关键词
-
-```
-keyword1, keyword2, "exact phrase"
-```
-
-## 使用方法
-
-### 基础用法
-
-```bash
-# 示例命令
-your-command-here
-```
-
-### 高级用法
-
-```yaml
-# 配置示例
-key: value
-```
-
-## 输出格式
-
-描述这个技能的输出结果格式。
-
-## 注意事项
-
-- 注意事项 1
-- 注意事项 2
-
-## 相关技能
-
-- [related-skill](../related-skill/)
-- [another-skill](../another-skill/)
-
-## 更新日志
-
-### 1.0.0 (YYYY-MM-DD)
-- 初始版本

package/.claude/skills/my-skill/examples/basic.md

@@ -1,3 +0,0 @@
-# Basic Example for my-skill
-
-Replace this with your actual example.

package/.claude/skills/my-skill/metadata.yaml

@@ -1,30 +0,0 @@
-# Skill Metadata
-# 这个文件定义技能的基本信息，用于自动发现和索引
-
-name: my-skill
-version: 1.0.0
-author: @username
-description: 简短描述技能功能
-
-tags:
-  - category1
-  - category2
-
-triggers:
-  - keyword1
-  - keyword2
-  - "exact phrase"
-
-dependencies: []  # 依赖的其他技能
-
-difficulty: beginner  # beginner | intermediate | advanced
-
-# 模板文件
-templates:
-  - name: default
-    file: templates/default.md
-
-# 示例文件
-examples:
-  - name: basic
-    file: examples/basic.md

package/.claude/skills/my-skill/templates/default.md

@@ -1,3 +0,0 @@
-# Default Template for my-skill
-
-Replace this with your actual template.

package/.claude/skills/test-skill-name/SKILL.md

@@ -1,61 +0,0 @@
-# Test Skill Name
-
-> 简短描述这个技能的作用（一句话）
-
-**版本**: 1.0.0
-**作者**: @username
-**标签**: [category1, category2]
-**难度**: 初级/中级/高级
-
----
-
-## 概述
-
-详细描述这个技能的功能和用途。
-
-## 适用场景
-
-- 场景 1
-- 场景 2
-- 场景 3
-
-## 触发关键词
-
-```
-keyword1, keyword2, "exact phrase"
-```
-
-## 使用方法
-
-### 基础用法
-
-```bash
-# 示例命令
-your-command-here
-```
-
-### 高级用法
-
-```yaml
-# 配置示例
-key: value
-```
-
-## 输出格式
-
-描述这个技能的输出结果格式。
-
-## 注意事项
-
-- 注意事项 1
-- 注意事项 2
-
-## 相关技能
-
-- [related-skill](../related-skill/)
-- [another-skill](../another-skill/)
-
-## 更新日志
-
-### 1.0.0 (YYYY-MM-DD)
-- 初始版本

package/.claude/skills/test-skill-name/examples/basic.md

@@ -1,3 +0,0 @@
-# Basic Example for test-skill-name
-
-Replace this with your actual example.

package/.claude/skills/test-skill-name/metadata.yaml

@@ -1,30 +0,0 @@
-# Skill Metadata
-# 这个文件定义技能的基本信息，用于自动发现和索引
-
-name: test-skill-name
-version: 1.0.0
-author: @username
-description: 简短描述技能功能
-
-tags:
-  - category1
-  - category2
-
-triggers:
-  - keyword1
-  - keyword2
-  - "exact phrase"
-
-dependencies: []  # 依赖的其他技能
-
-difficulty: beginner  # beginner | intermediate | advanced
-
-# 模板文件
-templates:
-  - name: default
-    file: templates/default.md
-
-# 示例文件
-examples:
-  - name: basic
-    file: examples/basic.md

package/.claude/skills/test-skill-name/templates/default.md

@@ -1,3 +0,0 @@
-# Default Template for test-skill-name
-
-Replace this with your actual template.