sumulige-claude 1.3.1 → 1.3.3

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

@@ -0,0 +1,61 @@
+# 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

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

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

@@ -0,0 +1,30 @@
+# 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

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

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

@@ -0,0 +1,61 @@
+# 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

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

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

@@ -0,0 +1,30 @@
+# 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

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

package/.claude/skills/template/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: template-skill
+description: Replace with description of the skill and when Claude should use it.
+---
+
+# Insert instructions below

package/.claude/skills/template/metadata.yaml

@@ -0,0 +1,30 @@
+# Skill Metadata
+# 这个文件定义技能的基本信息，用于自动发现和索引
+
+name: 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/SKILL.md

@@ -0,0 +1,61 @@
+# 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

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

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

@@ -0,0 +1,30 @@
+# 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

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

package/CHANGELOG.md

@@ -1,3 +1,38 @@
+## [1.3.3](https://github.com/sumulige/sumulige-claude/compare/v1.3.2...v1.3.3) (2026-01-22)
+
+### ✨ New Features
+
+- **`smc sync --hooks`**: Incremental hooks update for existing projects
+  - Adds new lifecycle hooks without overwriting customizations
+  - Merges SessionStart/SessionEnd/PreCompact into existing settings.json
+
+### 📝 Documentation
+
+- Add Layer 7: Lifecycle Hooks section to README
+- Document update methods for other projects
+
+---
+
+## [1.3.2](https://github.com/sumulige/sumulige-claude/compare/v1.3.1...v1.3.2) (2026-01-22)
+
+### ✨ New Features
+
+- **Official Hooks Integration**: Claude Code lifecycle auto-sync
+  - `SessionStart` → `memory-loader.cjs`: Auto-load MEMORY.md, ANCHORS.md, restore TODO state
+  - `SessionEnd` → `memory-saver.cjs`: Auto-save session summary, archive session, sync TODO
+  - `PreCompact` → `auto-handoff.cjs`: Auto-generate handoff before context compression
+- **Context Preservation**: Automatic handoff documents in `.claude/handoffs/`
+  - Includes active TODOs, recently modified files, recovery commands
+  - `LATEST.md` always points to most recent handoff
+
+### 🔧 Improvements
+
+- Session state tracking via `.session-state.json`
+- Automatic session archiving to `.claude/sessions/`
+- Memory entries kept for 7 days with auto-cleanup
+
+---
+
 ## [1.3.1](https://github.com/sumulige/sumulige-claude/compare/v1.3.0...v1.3.1) (2026-01-22)
 
 ### ✨ New Features

package/README.md

@@ -400,6 +400,68 @@ smc skill:create my-skill
 
 ---
 
+## Layer 7: Lifecycle Hooks / 第七层：生命周期钩子
+
+### Auto-Sync System / 自动同步系统
+
+> v1.3.2: 利用 Claude Code 官方 Hook 事件实现记忆自动同步
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  SessionStart ──► memory-loader.cjs                         │
+│    └─ 自动加载 MEMORY.md, ANCHORS.md, TODO 状态              │
+│                                                              │
+│  PreCompact ──► auto-handoff.cjs                            │
+│    └─ 上下文压缩前自动生成 handoff 文档                       │
+│                                                              │
+│  SessionEnd ──► memory-saver.cjs                            │
+│    └─ 会话结束自动保存摘要到 MEMORY.md                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Hook Files / 钩子文件
+
+| Hook | 文件 | 触发时机 | 功能 |
+|------|------|----------|------|
+| `SessionStart` | `memory-loader.cjs` | 会话开始 | 加载记忆、锚点、TODO |
+| `SessionEnd` | `memory-saver.cjs` | 会话结束 | 保存摘要、归档会话 |
+| `PreCompact` | `auto-handoff.cjs` | 上下文压缩前 | 生成 handoff 保护上下文 |
+
+### Handoff Documents / 交接文档
+
+当上下文即将被压缩时，自动生成交接文档：
+
+```
+.claude/handoffs/
+├── LATEST.md           # 最新交接文档
+├── INDEX.md            # 交接文档索引
+└── handoff_*.md        # 历史交接文档
+```
+
+每个交接文档包含：
+- 会话信息（项目、版本、开始时间）
+- 活跃 TODOs 列表
+- 最近修改的文件
+- 恢复命令
+
+### Update Hooks / 更新钩子
+
+其他项目如何获取新 hooks：
+
+```bash
+# 方式 1: 完整更新（推荐）
+smc template --force
+
+# 方式 2: 增量同步（仅更新 hooks）
+smc sync --hooks
+
+# 方式 3: 手动安装
+npm update -g sumulige-claude
+smc template
+```
+
+---
+
 ## Documentation / 文档
 
 - **[Development Guide / 开发指南](docs/DEVELOPMENT.md)** - Architecture, adding skills / 架构、添加技能

package/cli.js

@@ -30,7 +30,7 @@ const COMMANDS = {
   },
   sync: {
     help: 'Sync to current project (auto-migrates old format)',
-    args: '[--check-update]'
+    args: '[--check-update] [--hooks]'
   },
   migrate: {
     help: 'Migrate old hooks format to new',

package/development/todos/.state.json

@@ -13,5 +13,7 @@
       "notified": true
     }
   },
-  "transitions": []
+  "transitions": [],
+  "lastSynced": "2026-01-22T13:07:26.625Z",
+  "sessionId": "unknown"
 }

package/lib/commands.js

@@ -335,6 +335,7 @@ const commands = {
   // -------------------------------------------------------------------------
   sync: async (...args) => {
     const forceCheckUpdate = args.includes("--check-update");
+    const syncHooks = args.includes("--hooks");
 
     console.log("🔄 Syncing Sumulige Claude to current project...");
     console.log("");
@@ -387,6 +388,88 @@ const commands = {
       }
     }
 
+    // Sync hooks if --hooks flag is provided
+    if (syncHooks) {
+      const templateHooksDir = path.join(TEMPLATE_DIR, ".claude", "hooks");
+      const projectHooksDir = path.join(projectConfigDir, "hooks");
+      const templateSettingsFile = path.join(
+        TEMPLATE_DIR,
+        ".claude",
+        "settings.json",
+      );
+      const projectSettingsFile = path.join(projectConfigDir, "settings.json");
+
+      if (fs.existsSync(templateHooksDir)) {
+        ensureDir(projectHooksDir);
+
+        // Sync hook files (only add new ones, don't overwrite)
+        const hookFiles = fs
+          .readdirSync(templateHooksDir)
+          .filter((f) => f.endsWith(".cjs"));
+        let syncedCount = 0;
+
+        hookFiles.forEach((hookFile) => {
+          const src = path.join(templateHooksDir, hookFile);
+          const dest = path.join(projectHooksDir, hookFile);
+
+          if (!fs.existsSync(dest)) {
+            fs.copyFileSync(src, dest);
+            setExecutablePermission(dest);
+            syncedCount++;
+            console.log(`   ✅ Added ${hookFile}`);
+          }
+        });
+
+        if (syncedCount > 0) {
+          console.log(`✅ Synced ${syncedCount} new hook(s)`);
+        } else {
+          console.log("✅ Hooks up to date");
+        }
+      }
+
+      // Sync settings.json (merge new lifecycle hooks)
+      if (
+        fs.existsSync(templateSettingsFile) &&
+        fs.existsSync(projectSettingsFile)
+      ) {
+        try {
+          const templateSettings = JSON.parse(
+            fs.readFileSync(templateSettingsFile, "utf-8"),
+          );
+          const projectSettings = JSON.parse(
+            fs.readFileSync(projectSettingsFile, "utf-8"),
+          );
+
+          // Merge new lifecycle hooks
+          const lifecycleHooks = [
+            "SessionStart",
+            "SessionEnd",
+            "PreCompact",
+            "env",
+          ];
+          let updated = false;
+
+          lifecycleHooks.forEach((hook) => {
+            if (templateSettings[hook] && !projectSettings[hook]) {
+              projectSettings[hook] = templateSettings[hook];
+              updated = true;
+              console.log(`   ✅ Added ${hook} hook`);
+            }
+          });
+
+          if (updated) {
+            fs.writeFileSync(
+              projectSettingsFile,
+              JSON.stringify(projectSettings, null, 2),
+            );
+            console.log("✅ Updated settings.json");
+          }
+        } catch (e) {
+          console.log("⚠️  Failed to merge settings.json");
+        }
+      }
+    }
+
     // Sync todos directory structure
     const todosTemplateDir = path.join(TEMPLATE_DIR, "development", "todos");
     const todosProjectDir = path.join(projectDir, "development", "todos");

package/package.json

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