sumulige-claude 1.0.6 → 1.0.8

package/.claude/hooks/thinking-silent.cjs

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * ThinkingLens 无感知追踪
+ *
+ * 特点：
+ * - 完全静默，0 输出
+ * - 自动追踪对话流
+ * - 智能判断重要时刻
+ * - 后台运行，不打扰
+ * - 定期同步到 PROJECT_LOG.md（每 20 轮）
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const THINKING_DIR = path.join(process.env.CLAUDE_PROJECT_DIR, '.claude/thinking-routes');
+const ACTIVITY_FILE = path.join(THINKING_DIR, '.conversation-flow.json');
+const SESSION_FILE = path.join(THINKING_DIR, '.current-session');
+const SYNC_MARKER_FILE = path.join(THINKING_DIR, '.last-sync');
+const SYNC_INTERVAL = 20; // 每 20 轮同步一次
+
+// 确保目录存在
+try { fs.mkdirSync(THINKING_DIR, { recursive: true }); } catch (e) {}
+
+// 获取当前会话
+function getSession() {
+  let sessionId = fs.existsSync(SESSION_FILE)
+    ? fs.readFileSync(SESSION_FILE, 'utf-8').trim()
+    : null;
+
+  if (!sessionId) {
+    const date = new Date().toISOString().split('T')[0].replace(/-/g, '');
+    const project = path.basename(process.env.CLAUDE_PROJECT_DIR).slice(0, 10);
+    sessionId = `s-${date}-${project}`;
+    fs.writeFileSync(SESSION_FILE, sessionId);
+  }
+
+  return sessionId;
+}
+
+// 获取对话流数据
+function getConversationFlow() {
+  if (!fs.existsSync(ACTIVITY_FILE)) {
+    return { sessionId: getSession(), turns: [], startTime: new Date().toISOString() };
+  }
+  try {
+    return JSON.parse(fs.readFileSync(ACTIVITY_FILE, 'utf-8'));
+  } catch (e) {
+    return { sessionId: getSession(), turns: [], startTime: new Date().toISOString() };
+  }
+}
+
+// 保存对话流
+function saveConversationFlow(data) {
+  // 只保留最近 100 条
+  if (data.turns.length > 100) {
+    data.turns = data.turns.slice(-100);
+  }
+  fs.writeFileSync(ACTIVITY_FILE, JSON.stringify(data, null, 2));
+}
+
+// 检查是否需要同步到日志
+function shouldSync(turnCount) {
+  const lastSync = fs.existsSync(SYNC_MARKER_FILE)
+    ? parseInt(fs.readFileSync(SYNC_MARKER_FILE, 'utf-8'), 10)
+    : 0;
+  return turnCount - lastSync >= SYNC_INTERVAL;
+}
+
+// 标记已同步
+function markSynced(turnCount) {
+  fs.writeFileSync(SYNC_MARKER_FILE, turnCount.toString());
+}
+
+// 静默同步到 PROJECT_LOG.md
+function syncToLog() {
+  const syncScript = path.join(process.env.CLAUDE_PROJECT_DIR, '.claude/hooks/sync-to-log.sh');
+  if (fs.existsSync(syncScript)) {
+    try {
+      // 使用 spawn 静默执行，不输出任何内容
+      spawn('bash', [syncScript], {
+        stdio: 'ignore',
+        detached: true
+      }).unref();
+    } catch (e) {
+      // 静默忽略错误
+    }
+  }
+}
+
+// 检测是否是关键操作
+function detectKeyOperation(toolInput, toolName) {
+  const keywords = [
+    '完成', '实现', '创建', '添加', '修复', '更新',
+    '完成', '测试', '部署', '推送', '设计', '决定'
+  ];
+
+  // 如果包含关键词，可能是关键操作
+  if (keywords.some(k => toolInput.includes(k))) {
+    return 'potential-action';
+  }
+
+  // 如果是代码编辑
+  if (toolName === 'Edit' || toolName === 'Write') {
+    return 'code-edit';
+  }
+
+  return 'normal';
+}
+
+// 主函数 - 完全静默
+function main() {
+  try {
+    const sessionId = getSession();
+    const flow = getConversationFlow();
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+    const toolName = process.env.CLAUDE_TOOL_NAME || '';
+
+    // 添加新的对话轮次
+    flow.turns.push({
+      time: new Date().toISOString(),
+      toolName,
+      inputLength: toolInput.length,
+      type: detectKeyOperation(toolInput, toolName),
+    });
+
+    saveConversationFlow(flow);
+
+    // 检查是否需要同步到日志
+    const turnCount = flow.turns.length;
+    if (shouldSync(turnCount)) {
+      syncToLog();
+      markSynced(turnCount);
+    }
+
+  } catch (e) {
+    // 完全静默，忽略任何错误
+  }
+
+  // 永远不输出任何内容
+  process.exit(0);
+}
+
+main();

package/.claude/hooks/tl-summary.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# tl-summary - 查看今日对话摘要
+#
+# 用法：
+#   .claude/hooks/tl-summary.sh
+
+# 自动检测项目目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(cd "$SCRIPT_DIR/../.." && pwd)}"
+
+THINKING_DIR="$CLAUDE_PROJECT_DIR/.claude/thinking-routes"
+FLOW_FILE="$THINKING_DIR/.conversation-flow.json"
+
+if [[ ! -f "$FLOW_FILE" ]]; then
+  echo "📭 暂无对话记录"
+  exit 0
+fi
+
+# 解析 JSON（使用 Node.js）
+node -e "
+const fs = require('fs');
+const flow = JSON.parse(fs.readFileSync('$FLOW_FILE', 'utf-8'));
+
+console.log('');
+console.log('📅 今日对话摘要');
+console.log('─'.repeat(40));
+console.log('会话 ID: ' + flow.sessionId);
+console.log('开始时间: ' + new Date(flow.startTime).toLocaleString('zh-CN'));
+console.log('对话轮次: ' + flow.turns.length);
+console.log('');
+
+// 统计操作类型
+const types = {};
+flow.turns.forEach(t => {
+  types[t.type] = (types[t.type] || 0) + 1;
+});
+
+console.log('📊 操作统计:');
+Object.entries(types).forEach(([type, count]) => {
+  const emoji = type === 'potential-action' ? '⚡' :
+                type === 'code-edit' ? '📝' : '💬';
+  console.log('  ' + emoji + ' ' + type + ': ' + count);
+});
+console.log('');
+
+// 显示最近 5 个操作
+console.log('🕐 最近活动:');
+flow.turns.slice(-5).reverse().forEach(t => {
+  const time = new Date(t.time).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
+  const emoji = t.type === 'potential-action' ? '⚡' :
+                t.type === 'code-edit' ? '📝' : '💬';
+  console.log('  ' + time + ' ' + emoji + ' ' + t.toolName);
+});
+"

package/.claude/hooks/todo-manager.cjs

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+/**
+ * TODO Manager - AI 自动任务管理系统
+ *
+ * 功能：
+ * - 自动追踪项目任务
+ * - 生成可点击的任务索引
+ * - 维护任务状态流转
+ * - 静默运行，不打扰工作流
+ *
+ * 目录结构：
+ * development/todos/
+ * ├── INDEX.md       # 任务总览
+ * ├── active/        # 进行中的任务
+ * ├── completed/     # 已完成的任务
+ * ├── backlog/       # 待办任务
+ * └── archived/      # 已归档任务
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const TODOS_DIR = path.join(PROJECT_DIR, 'development', 'todos');
+const INDEX_FILE = path.join(TODOS_DIR, 'INDEX.md');
+const STATE_FILE = path.join(TODOS_DIR, '.state.json');
+
+// 任务状态
+const STATUS = {
+  ACTIVE: 'active',
+  COMPLETED: 'completed',
+  BACKLOG: 'backlog',
+  ARCHIVED: 'archived'
+};
+
+// 确保目录存在
+function ensureDirectories() {
+  [TODOS_DIR, STATUS.ACTIVE, STATUS.COMPLETED, STATUS.BACKLOG, STATUS.ARCHIVED].forEach(dir => {
+    const fullPath = dir.startsWith('/') ? dir : path.join(TODOS_DIR, dir);
+    try { fs.mkdirSync(fullPath, { recursive: true }); } catch (e) {}
+  });
+}
+
+// 扫描任务文件
+function scanTasks() {
+  const tasks = {
+    active: [],
+    completed: [],
+    backlog: [],
+    archived: []
+  };
+
+  for (const [key, dirName] of Object.entries(STATUS)) {
+    const dir = path.join(TODOS_DIR, dirName);
+    if (!fs.existsSync(dir)) continue;
+
+    const files = fs.readdirSync(dir)
+      .filter(f => f.endsWith('.md') && f !== '_README.md');
+
+    tasks[dirName] = files.map(f => {
+      const filePath = path.join(dir, f);
+      const content = fs.readFileSync(filePath, 'utf-8');
+      const titleMatch = content.match(/^#\s+(.+)$/m);
+      const statusMatch = content.match(/\*\*状态\*\*:\s*([\u{1F300}-\u{1F9FF}\s]+)/u);
+      const priorityMatch = content.match(/\*\*优先级\*\*:\s*(P[0-3])/);
+      const branchMatch = content.match(/\*\*分支\*\*:\s*`([^`]+)`/);
+
+      return {
+        file: f,
+        title: titleMatch ? titleMatch[1] : path.basename(f, '.md'),
+        status: statusMatch ? statusMatch[1].trim() : '🚧 进行中',
+        priority: priorityMatch ? priorityMatch[1] : 'P2',
+        branch: branchMatch ? branchMatch[1] : null,
+        path: `${dirName}/${f}`
+      };
+    });
+  }
+
+  return tasks;
+}
+
+// 生成任务索引
+function generateIndex(tasks) {
+  const now = new Date().toISOString().split('T')[0];
+
+  let md = `# 项目任务追踪系统
+
+> 本目录由 AI 自动维护，记录项目开发任务和进度
+
+**最后更新**: ${now}
+
+@version: 1.0.0
+
+## 目录结构
+
+\`\`\`
+development/todos/
+├── INDEX.md           # 本文件 - 任务总览
+├── active/            # 进行中的任务 (${tasks.active.length})
+├── completed/         # 已完成的任务 (${tasks.completed.length})
+├── backlog/           # 待规划的任务 (${tasks.backlog.length})
+└── archived/          # 已归档的任务 (${tasks.archived.length})
+\`\`\`
+
+## 快速跳转
+
+`;
+
+  // 进行中的任务
+  md += `## 🚧 进行中的任务 (${tasks.active.length})\n\n`;
+  if (tasks.active.length > 0) {
+    tasks.active.forEach(t => {
+      md += `- [${t.priority}] [${t.title}](./${t.path}) - ${t.status}${t.branch ? ` \`branch: ${t.branch}\`` : ''}\n`;
+    });
+  } else {
+    md += `*暂无进行中的任务*\n`;
+  }
+  md += `\n`;
+
+  // 最近完成的任务（最多5个）
+  md += `## ✅ 最近完成的任务\n\n`;
+  const recentCompleted = tasks.completed.slice(0, 5);
+  if (recentCompleted.length > 0) {
+    recentCompleted.forEach(t => {
+      md += `- [${t.title}](./${t.path})\n`;
+    });
+    if (tasks.completed.length > 5) {
+      md += `- ...还有 ${tasks.completed.length - 5} 个已完成任务\n`;
+    }
+  } else {
+    md += `*暂无已完成的任务*\n`;
+  }
+  md += `\n`;
+
+  // 待办任务
+  md += `## 📋 待办任务 (${tasks.backlog.length})\n\n`;
+  if (tasks.backlog.length > 0) {
+    tasks.backlog.slice(0, 10).forEach(t => {
+      md += `- [${t.priority}] [${t.title}](./${t.path})\n`;
+    });
+    if (tasks.backlog.length > 10) {
+      md += `- ...还有 ${tasks.backlog.length - 10} 个待办任务\n`;
+    }
+  } else {
+    md += `*暂无待办任务*\n`;
+  }
+  md += `\n`;
+
+  // 全部目录链接
+  md += `## 全部目录\n\n`;
+  md += `- [🚧 所有进行中的任务](./active/) - 当前开发重点\n`;
+  md += `- [✅ 所有已完成的任务](./completed/) - 完整历史\n`;
+  md += `- [📋 所有待办任务](./backlog/) - 待规划\n`;
+  md += `- [📦 所有已归档任务](./archived/) - 历史记录\n`;
+  md += `\n`;
+
+  // 使用说明
+  md += `## 使用方式\n\n`;
+  md += `### 查看任务\n`;
+  md += `点击上方链接跳转到对应目录，或使用：\n`;
+  md += `\`\`\`bash\n`;
+  md += `# 查看进行中的任务\n`;
+  md += `cat development/todos/active/*.md\n\n`;
+  md += `# 查看特定任务\n`;
+  md += `cat development/todos/active/feature-name.md\n`;
+  md += `\`\`\`\n\n`;
+  md += `### 创建新任务\n`;
+  md += `在 Claude Code 中：\n`;
+  md += `\`\`\`\n`;
+  md += `创建一个新任务：实现用户登录功能\n`;
+  md += `\`\`\`\n\n`;
+  md += `AI 会自动在 \`active/\` 目录创建对应的任务文件。\n\n`;
+  md += `### 更新任务状态\n`;
+  md += `\`\`\`\n`;
+  md += `将 [任务名] 标记为完成\n`;
+  md += `\`\`\`\n\n`;
+  md += `AI 会自动将任务移动到 \`completed/\` 目录。\n\n`;
+
+  md += `---\n\n`;
+  md += `> **维护说明**: 本系统由 AI 自动维护，请勿手动编辑（除非你知道自己在做什么）\n`;
+
+  return md;
+}
+
+// 更新索引
+function updateIndex() {
+  try {
+    ensureDirectories();
+    const tasks = scanTasks();
+    const index = generateIndex(tasks);
+
+    // 检查是否需要更新 - 比较任务总数
+    let needsUpdate = true;
+    if (fs.existsSync(INDEX_FILE)) {
+      const existing = fs.readFileSync(INDEX_FILE, 'utf-8');
+      // 从现有索引中提取任务数量
+      const activeMatch = existing.match(/## 🚧 进行中的任务 \((\d+)\)/);
+      const completedMatch = existing.match(/## ✅ 最近完成的任务/);
+      const existingActive = activeMatch ? parseInt(activeMatch[1], 10) : 0;
+      const newActive = tasks.active.length;
+
+      // 如果活跃任务数量相同且没有完成任务内容变化，则不更新
+      if (existingActive === newActive && tasks.completed.length === 0) {
+        // 检查现有索引是否已有完成任务
+        const hasCompletedInExisting = existing.includes('[completed/') || existing.includes('./completed/');
+        const hasCompletedNow = tasks.completed.length > 0;
+        needsUpdate = hasCompletedInExisting !== hasCompletedNow;
+      }
+    }
+
+    if (needsUpdate) {
+      fs.writeFileSync(INDEX_FILE, index);
+    }
+
+    return { tasks, updated: needsUpdate };
+  } catch (e) {
+    return { tasks: { active: [], completed: [], backlog: [], archived: [] }, updated: false };
+  }
+}
+
+// 主函数
+function main() {
+  const result = updateIndex();
+
+  // 在 AgentStop 或特定事件时输出摘要
+  const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+  if (eventType === 'AgentStop') {
+    const { active, completed } = result.tasks;
+    if (active.length > 0) {
+      console.log(`\n📋 [任务追踪] ${active.length} 个进行中, ${completed.length} 个已完成`);
+      console.log(`   查看: development/todos/INDEX.md\n`);
+    }
+  }
+
+  process.exit(0);
+}
+
+// 如果直接运行，强制更新索引
+if (require.main === module) {
+  if (process.argv[2] === '--force') {
+    updateIndex();
+    console.log('✅ Task index updated');
+  } else {
+    main();
+  }
+} else {
+  main();
+}

package/.claude/hooks/verify-work.cjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * Verify Work Hook - 验证反馈循环
+ *
+ * 根据 Boris Cherny 的最佳实践，这是获得高质量结果的关键。
+ * 在重要任务完成后自动触发验证流程，能让最终质量提升 2-3 倍。
+ *
+ * 触发时机：
+ * - AgentStop 事件（会话结束时）
+ * - 检测到关键操作完成（如 commit、push 等）
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const VERIFY_DIR = path.join(PROJECT_DIR, '.claude/verify');
+const VERIFY_PENDING_FILE = path.join(VERIFY_DIR, '.pending-verify.json');
+const VERIFY_LOG_FILE = path.join(VERIFY_DIR, 'verify-log.md');
+
+// 确保目录存在
+try { fs.mkdirSync(VERIFY_DIR, { recursive: true }); } catch (e) {}
+
+// 检测是否需要验证
+function shouldVerify(toolName, toolInput) {
+  // 在这些操作后建议验证
+  const verifyAfterOps = [
+    'git commit',
+    'git push',
+    'deploy',
+    'build',
+    'test',
+    'release'
+  ];
+
+  const lowerInput = toolInput.toLowerCase();
+  return verifyAfterOps.some(op => lowerInput.includes(op));
+}
+
+// 获取待验证任务
+function getPendingVerifies() {
+  if (!fs.existsSync(VERIFY_PENDING_FILE)) {
+    return [];
+  }
+  try {
+    return JSON.parse(fs.readFileSync(VERIFY_PENDING_FILE, 'utf-8'));
+  } catch (e) {
+    return [];
+  }
+}
+
+// 保存待验证任务
+function savePendingVerifies(tasks) {
+  fs.writeFileSync(VERIFY_PENDING_FILE, JSON.stringify(tasks, null, 2));
+}
+
+// 添加验证提示到输出
+function addVerifyHint(toolInput) {
+  const hints = {
+    'git commit': '建议运行测试套件验证更改是否破坏现有功能',
+    'git push': '建议在 CI/CD 中确认所有检查通过',
+    'deploy': '建议在预发布环境验证关键用户流程',
+    'build': '建议运行构建产物检查是否有警告',
+    'test': '建议检查测试覆盖率是否满足要求',
+    'release': '建议进行完整的回归测试'
+  };
+
+  for (const [key, hint] of Object.entries(hints)) {
+    if (toolInput.toLowerCase().includes(key)) {
+      return hint;
+    }
+  }
+  return '建议验证核心功能是否正常工作';
+}
+
+// 记录验证日志
+function logVerify(action, hint) {
+  const timestamp = new Date().toISOString();
+  const logEntry = `\n## ${timestamp}\n**操作**: ${action}\n**验证建议**: ${hint}\n`;
+
+  if (!fs.existsSync(VERIFY_LOG_FILE)) {
+    fs.writeFileSync(VERIFY_LOG_FILE, `# 验证日志\n\n此文件记录所有建议验证的操作。\n${logEntry}`);
+  } else {
+    fs.appendFileSync(VERIFY_LOG_FILE, logEntry);
+  }
+}
+
+// 主函数
+function main() {
+  try {
+    const toolName = process.env.CLAUDE_TOOL_NAME || '';
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+    const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+
+    // 检查是否需要验证
+    if (shouldVerify(toolName, toolInput)) {
+      const hint = addVerifyHint(toolInput);
+
+      // 保存到待验证列表
+      const pending = getPendingVerifies();
+      pending.push({
+        time: new Date().toISOString(),
+        action: toolName + ': ' + toolInput.slice(0, 100),
+        hint
+      });
+      savePendingVerifies(pending);
+
+      // 记录到日志
+      logVerify(toolName, hint);
+
+      // 输出验证提示（仅在非 PostToolUse 事件，避免重复）
+      if (eventType !== 'PostToolUse') {
+        console.log(`\n🔍 [验证提醒] ${hint}`);
+        console.log(`使用 /verify-work 查看待验证任务列表\n`);
+      }
+    }
+
+    // AgentStop 时显示待验证任务摘要
+    if (eventType === 'AgentStop') {
+      const pending = getPendingVerifies();
+      if (pending.length > 0) {
+        console.log(`\n🔍 [待验证任务] 还有 ${pending.length} 个任务待验证`);
+        console.log(`使用 /verify-work 查看详情并标记完成\n`);
+      }
+    }
+
+  } catch (e) {
+    // 静默处理错误
+  }
+
+  process.exit(0);
+}
+
+main();