sumulige-claude 1.1.2 → 1.2.0

package/.claude/templates/hooks/hook.sh.template

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+#
+# [Hook Name] - Shell Hook Template
+#
+# 触发时机: [说明触发时机]
+# 环境变量:
+#   - CLAUDE_PROJECT_DIR: 项目根目录
+#
+# @version 1.0.0
+#
+
+set -euo pipefail  # 严格模式
+
+# ============================================================
+# 标准头部 - 所有 hooks 必须包含
+# ============================================================
+
+# 获取项目目录，提供 fallback
+CLAUDE_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+
+# 如果不在项目环境中，静默退出
+[[ -z "${CLAUDE_PROJECT_DIR:-}" ]] && exit 0
+
+# ============================================================
+# 配置区域
+# ============================================================
+
+VERBOSE="${VERBOSE:-false}"
+HOOKS_DIR="$CLAUDE_PROJECT_DIR/.claude/hooks"
+DATA_DIR="$HOOKS_DIR/.data"
+
+# ============================================================
+# 工具函数
+// ============================================================
+
+# 安全日志
+log() {
+    if [[ "$VERBOSE" == "true" ]]; then
+        echo "[Hook] $*" >&2
+    fi
+}
+
+# 确保目录存在
+ensure_dir() {
+    local dir="$1"
+    mkdir -p "$dir" 2>/dev/null || true
+}
+
+# 安全读取文件
+safe_read() {
+    local file="$1"
+    local default="${2:-}"
+    if [[ -f "$file" ]]; then
+        cat "$file" 2>/dev/null || echo "$default"
+    else
+        echo "$default"
+    fi
+}
+
+# 安全写入文件
+safe_write() {
+    local file="$1"
+    local content="$2"
+    ensure_dir "$(dirname "$file")"
+    echo "$content" > "$file" 2>/dev/null || true
+}
+
+# ============================================================
+# Hook 核心逻辑
+# ============================================================
+
+main() {
+    # 错误处理：任何错误都静默处理，不影响 Claude Code
+    {
+
+        log "Project: $CLAUDE_PROJECT_DIR"
+
+        # ===== 在这里实现你的 hook 逻辑 =====
+
+        # 示例: 记录执行时间
+        local timestamp_file="$DATA_DIR/last-run.txt"
+        safe_write "$timestamp_file" "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+        # ===== Hook 逻辑结束 =====
+
+    } || true
+}
+
+# ============================================================
+# 执行
+# ============================================================
+
+main
+exit 0

package/.claude/templates/hooks/user-prompt-submit.cjs.template

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * [Hook Name] - UserPromptSubmit Hook Template
+ *
+ * 触发时机: 用户每次提交提示时
+ * 环境变量:
+ *   - CLAUDE_PROJECT_DIR: 项目根目录
+ *   - CLAUDE_TOOL_NAME: 当前调用的工具名
+ *   - CLAUDE_TOOL_INPUT: 工具输入内容
+ *
+ * @version 1.0.0
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ============================================================
+// 标准头部 - 所有 hooks 必须包含
+// ============================================================
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
+// ============================================================
+// 配置区域
+// ============================================================
+
+const CONFIG = {
+  // 你的 hook 配置
+  enabled: true,
+  verbose: false,  // 设为 true 开启调试输出
+};
+
+// ============================================================
+// 工具函数
+// ============================================================
+
+/**
+ * 安全日志 - 只有 verbose=true 时才输出
+ */
+function log(...args) {
+  if (CONFIG.verbose) {
+    console.error('[Hook]', ...args);
+  }
+}
+
+/**
+ * 安全读取文件
+ */
+function safeReadFile(filePath, defaultValue = '') {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch (e) {
+    return defaultValue;
+  }
+}
+
+/**
+ * 安全写入文件
+ */
+function safeWriteFile(filePath, content) {
+  try {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+  } catch (e) {
+    log('Write error:', e.message);
+    return false;
+  }
+}
+
+// ============================================================
+// Hook 核心逻辑
+// ============================================================
+
+/**
+ * 主处理函数
+ */
+function main() {
+  try {
+    // 获取环境变量
+    const toolName = process.env.CLAUDE_TOOL_NAME || '';
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+
+    log('Tool:', toolName);
+    log('Project:', PROJECT_DIR);
+
+    // ===== 在这里实现你的 hook 逻辑 =====
+
+    // 示例: 追踪操作
+    const trackerFile = path.join(PROJECT_DIR, '.claude/hooks/.tracker.json');
+    const data = JSON.parse(safeReadFile(trackerFile, '{}'));
+    data.lastRun = new Date().toISOString();
+    data.runs = (data.runs || 0) + 1;
+    safeWriteFile(trackerFile, JSON.stringify(data, null, 2));
+
+    // ===== Hook 逻辑结束 =====
+
+  } catch (error) {
+    // 静默处理错误，不干扰用户对话
+    log('Error:', error.message);
+  }
+
+  // 永远输出成功，不影响 Claude Code 正常运行
+  process.exit(0);
+}
+
+// ============================================================
+// 执行
+// ============================================================
+
+main();

package/.claude/templates/hooks/user-response-submit.cjs.template

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * [Hook Name] - UserResponseSubmit Hook Template
+ *
+ * 触发时机: AI 返回响应后
+ * 环境变量:
+ *   - CLAUDE_PROJECT_DIR: 项目根目录
+ *   - CLAUDE_RESPONSE_CONTENT: 响应内容
+ *
+ * @version 1.0.0
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ============================================================
+// 标准头部 - 所有 hooks 必须包含
+// ============================================================
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
+// ============================================================
+// 配置区域
+// ============================================================
+
+const CONFIG = {
+  enabled: true,
+  verbose: false,
+};
+
+// ============================================================
+// 工具函数
+// ============================================================
+
+function log(...args) {
+  if (CONFIG.verbose) {
+    console.error('[Hook]', ...args);
+  }
+}
+
+function safeReadFile(filePath, defaultValue = '') {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch (e) {
+    return defaultValue;
+  }
+}
+
+function safeWriteFile(filePath, content) {
+  try {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+  } catch (e) {
+    log('Write error:', e.message);
+    return false;
+  }
+}
+
+// ============================================================
+// Hook 核心逻辑
+// ============================================================
+
+function main() {
+  try {
+    const responseContent = process.env.CLAUDE_RESPONSE_CONTENT || '';
+
+    log('Response length:', responseContent.length);
+
+    // ===== 在这里实现你的 hook 逻辑 =====
+
+    // 示例: 记录响应统计
+    const statsFile = path.join(PROJECT_DIR, '.claude/hooks/.response-stats.json');
+    const stats = JSON.parse(safeReadFile(statsFile, '{}'));
+    stats.totalResponses = (stats.totalResponses || 0) + 1;
+    stats.totalChars = (stats.totalChars || 0) + responseContent.length;
+    stats.lastUpdate = new Date().toISOString();
+    safeWriteFile(statsFile, JSON.stringify(stats, null, 2));
+
+    // ===== Hook 逻辑结束 =====
+
+  } catch (error) {
+    log('Error:', error.message);
+  }
+
+  process.exit(0);
+}
+
+main();

package/.claude/templates/hooks/validate.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * Hook Validator - 检查 hook 是否符合最佳实践
+ *
+ * 使用方法:
+ *   node validate.js [hook-file]
+ *
+ * 示例:
+ *   node validate.js ../my-hook.cjs
+ *   node validate.js *.cjs
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const CHECKS = {
+  ENV_FALLBACK: {
+    name: '环境变量 fallback',
+    pattern: /process\.env\.CLAUDE_PROJECT_DIR\s*\|\|/,
+    required: true,
+    error: '缺少 CLAUDE_PROJECT_DIR fallback (|| process.cwd())'
+  },
+
+  SILENT_EXIT: {
+    name: '静默退出检查',
+    pattern: /if\s*\(\s*!process\.env\.CLAUDE_PROJECT_DIR/,
+    required: true,
+    error: '缺少非项目环境的静默退出检查'
+  },
+
+  ERROR_HANDLING: {
+    name: '错误处理',
+    pattern: /try\s*\{/,
+    required: true,
+    error: '缺少 try-catch 错误处理'
+  },
+
+  SAFE_EXIT: {
+    name: '安全退出',
+    pattern: /process\.exit\(0\)/,
+    required: true,
+    error: '缺少明确的 process.exit(0)'
+  },
+
+  NO_STDOUT: {
+    name: '避免 stdout 输出',
+    pattern: /console\.log\(/,
+    required: false,
+    error: '检测到 console.log - 建议使用 console.error 用于调试'
+  },
+
+  SAFE_MKDIR: {
+    name: '安全创建目录',
+    pattern: /mkdirSync.*recursive/,
+    required: true,
+    error: '目录创建缺少 { recursive: true } 选项'
+  }
+};
+
+/**
+ * 验证单个 hook 文件
+ */
+function validateHook(filePath) {
+  const results = {
+    file: filePath,
+    passed: 0,
+    failed: 0,
+    warnings: 0,
+    checks: []
+  };
+
+  if (!fs.existsSync(filePath)) {
+    results.error = '文件不存在';
+    return results;
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  for (const [key, check] of Object.entries(CHECKS)) {
+    const passed = check.pattern.test(content);
+
+    if (check.required) {
+      if (passed) {
+        results.passed++;
+      } else {
+        results.failed++;
+      }
+    } else {
+      // 可选检查作为警告
+      if (passed) {
+        results.warnings++;
+      }
+    }
+
+    results.checks.push({
+      name: check.name,
+      passed: check.required ? passed : !passed,
+      required: check.required,
+      error: check.error
+    });
+  }
+
+  return results;
+}
+
+/**
+ * 打印验证结果
+ */
+function printResults(results) {
+  console.log(`\n📎 ${path.basename(results.file)}`);
+  console.log('─'.repeat(50));
+
+  if (results.error) {
+    console.log(`❌ ${results.error}`);
+    return;
+  }
+
+  for (const check of results.checks) {
+    if (check.passed) {
+      console.log(`✅ ${check.name}`);
+    } else if (check.required) {
+      console.log(`❌ ${check.name}`);
+      console.log(`   ${check.error}`);
+    } else {
+      console.log(`⚠️  ${check.name}`);
+      console.log(`   ${check.error}`);
+    }
+  }
+
+  const total = results.passed + results.failed;
+  const score = total > 0 ? Math.round((results.passed / total) * 100) : 0;
+
+  console.log('─'.repeat(50));
+  console.log(`得分: ${score}% | ✅ ${results.passed} | ❌ ${results.failed} | ⚠️  ${results.warnings}`);
+}
+
+/**
+ * 主函数
+ */
+function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.log(`
+🔍 Hook Validator - 检查 hook 最佳实践
+
+使用方法:
+  node validate.js <hook-file>
+  node validate.js *.cjs
+
+示例:
+  node validate.js my-hook.cjs
+  node validate.js ../*.cjs
+    `);
+    process.exit(0);
+  }
+
+  let allPassed = true;
+
+  for (const arg of args) {
+    const results = validateHook(arg);
+    printResults(results);
+
+    if (results.failed > 0) {
+      allPassed = false;
+    }
+  }
+
+  console.log('');
+  process.exit(allPassed ? 0 : 1);
+}
+
+main();