sumulige-claude 1.1.2 → 1.2.0

package/.claude/hooks/code-formatter.cjs

@@ -15,6 +15,11 @@ const { spawn } = require('child_process');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 // 支持的格式化器配置
 const FORMATTERS = {
   // JavaScript/TypeScript
@@ -173,8 +178,8 @@ function main() {
 
     // 输出格式化结果（可选，用于调试）
     if (formatted.length > 0 && process.env.DEBUG_FORMATTER) {
-      console.log(`\n🎨 [格式化] 已格式化 ${formatted.length} 个文件:`);
-      formatted.forEach(f => console.log(`   - ${f.file} (${f.formatter})`));
+      console.error(`\n🎨 [格式化] 已格式化 ${formatted.length} 个文件:`);
+      formatted.forEach(f => console.error(`   - ${f.file} (${f.formatter})`));
     }
 
   } catch (e) {

package/.claude/hooks/multi-session.cjs

@@ -16,6 +16,12 @@ const path = require('path');
 const os = require('os');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 const SESSIONS_DIR = path.join(PROJECT_DIR, '.claude', 'sessions');
 const ACTIVE_SESSIONS_FILE = path.join(SESSIONS_DIR, 'active-sessions.json');
 const SESSION_LOCK_FILE = path.join(SESSIONS_DIR, '.session-lock');
@@ -123,13 +129,13 @@ function displaySessionStatus() {
   console.log(`   主机: ${getSessionIdentifier()}`);
 
   if (sessions.length > 1) {
-    console.log(`\n   其他活跃会话:`);
+    console.error(`\n   其他活跃会话:`);
     sessions
       .filter(s => s.id !== currentId)
       .forEach(s => {
         const number = s.number || '?';
         const duration = Math.round((Date.now() - s.startedAt) / 1000 / 60);
-        console.log(`   - 会话 #${number}: ${s.identifier} (${duration}分钟前启动)`);
+        console.error(`   - 会话 #${number}: ${s.identifier} (${duration}分钟前启动)`);
       });
   }
 
@@ -150,7 +156,7 @@ function main() {
     if (eventType === 'UserPromptSubmit' && toolInput.length > 20) {
       // 只在较长的用户输入时显示，避免噪音
       if (sessions.length > 1 || process.env.SHOW_SESSION_STATUS) {
-        console.log(`\n🔄 [会话 #${sessionNumber}] 活跃会话: ${sessions.length}\n`);
+        console.error(`\n🔄 [会话 #${sessionNumber}] 活跃会话: ${sessions.length}\n`);
       }
     }
 

package/.claude/hooks/project-kickoff.cjs

@@ -15,6 +15,12 @@ const fs = require('fs');
 const path = require('path');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 const TEMPLATES_DIR = path.join(PROJECT_DIR, '.claude/templates');
 const KICKOFF_FILE = path.join(PROJECT_DIR, 'PROJECT_KICKOFF.md');
 const PLAN_FILE = path.join(PROJECT_DIR, 'TASK_PLAN.md');
@@ -95,19 +101,24 @@ function generateKickoffHint() {
 
 // 主函数
 function main() {
-  // 如果项目已启动且不是强制模式，静默退出
-  if (isProjectStarted() && !isForceKickoff()) {
-    process.exit(0);
+  try {
+    // 如果项目已启动且不是强制模式，静默退出
+    if (isProjectStarted() && !isForceKickoff()) {
+      process.exit(0);
+    }
+
+    // 生成提示文件
+    const hint = generateKickoffHint();
+    fs.mkdirSync(path.dirname(HINT_FILE), { recursive: true });
+    fs.writeFileSync(HINT_FILE, hint);
+
+    // 同时输出到 stdout (供 AI 直接读取)
+    console.log(hint);
+
+  } catch (e) {
+    // 静默处理错误
   }
 
-  // 生成提示文件
-  const hint = generateKickoffHint();
-  fs.mkdirSync(path.dirname(HINT_FILE), { recursive: true });
-  fs.writeFileSync(HINT_FILE, hint);
-
-  // 同时输出到 stdout (供 AI 直接读取)
-  console.log(hint);
-
   process.exit(0);
 }
 

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

@@ -10,6 +10,12 @@ const fs = require('fs');
 const path = require('path');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 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');
@@ -147,6 +153,7 @@ function main() {
     // 将提示写入文件供 AI 阅读
     const hint = generateSkillLoadHint(matches);
     const hintFile = path.join(RAG_DIR, '.skill-hint.txt');
+    fs.mkdirSync(path.dirname(hintFile), { recursive: true });
     fs.writeFileSync(hintFile, hint + '\n');
 
   } catch (e) {

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

@@ -14,7 +14,13 @@ 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 PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
+const THINKING_DIR = path.join(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');
@@ -31,7 +37,7 @@ function getSession() {
 
   if (!sessionId) {
     const date = new Date().toISOString().split('T')[0].replace(/-/g, '');
-    const project = path.basename(process.env.CLAUDE_PROJECT_DIR).slice(0, 10);
+    const project = path.basename(PROJECT_DIR).slice(0, 10);
     sessionId = `s-${date}-${project}`;
     fs.writeFileSync(SESSION_FILE, sessionId);
   }
@@ -75,7 +81,7 @@ function markSynced(turnCount) {
 
 // 静默同步到 PROJECT_LOG.md
 function syncToLog() {
-  const syncScript = path.join(process.env.CLAUDE_PROJECT_DIR, '.claude/hooks/sync-to-log.sh');
+  const syncScript = path.join(PROJECT_DIR, '.claude/hooks/sync-to-log.sh');
   if (fs.existsSync(syncScript)) {
     try {
       // 使用 spawn 静默执行，不输出任何内容

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

@@ -16,6 +16,12 @@ const fs = require('fs');
 const path = require('path');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 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');
@@ -318,11 +324,11 @@ function main() {
 
   // 输出建议
   if (result.suggestions && result.suggestions.length > 0) {
-    console.log('\n📋 [任务流转] 检测到 ' + result.suggestions.length + ' 个自动流转建议:\n');
+    console.error('\n📋 [任务流转] 检测到 ' + result.suggestions.length + ' 个自动流转建议:\n');
     result.suggestions.forEach((s, i) => {
-      console.log(`   ${i + 1}. ${s.message}`);
+      console.error(`   ${i + 1}. ${s.message}`);
     });
-    console.log('');
+    console.error('');
   }
 
   // 在 AgentStop 时输出摘要
@@ -334,10 +340,10 @@ function main() {
     const completedTotal = completed.research.length + completed.develop.length + completed.test.length;
 
     if (activeTotal > 0 || completedTotal > 0) {
-      console.log(`\n📋 [任务追踪]`);
-      console.log(`   进行中: ${activeTotal} 个 (📊 ${active.research.length} | 💻 ${active.develop.length} | 🧪 ${active.test.length})`);
-      console.log(`   已完成: ${completedTotal} 个`);
-      console.log(`   查看: ${path.relative(PROJECT_DIR, INDEX_FILE)}\n`);
+      console.error(`\n📋 [任务追踪]`);
+      console.error(`   进行中: ${activeTotal} 个 (📊 ${active.research.length} | 💻 ${active.develop.length} | 🧪 ${active.test.length})`);
+      console.error(`   已完成: ${completedTotal} 个`);
+      console.error(`   查看: ${path.relative(PROJECT_DIR, INDEX_FILE)}\n`);
     }
   }
 
@@ -348,18 +354,18 @@ function main() {
 if (require.main === module) {
   if (process.argv[2] === '--force') {
     updateIndex();
-    console.log('✅ Task index updated');
+    console.error('✅ Task index updated');
   } else if (process.argv[2] === '--suggest') {
     const result = updateIndex();
     if (result.suggestions.length > 0) {
-      console.log('\n💡 自动流转建议:\n');
+      console.error('\n💡 自动流转建议:\n');
       result.suggestions.forEach((s, i) => {
-        console.log(`${i + 1}. ${s.message}`);
-        console.log(`   开发任务: ${s.developTask.file}`);
-        console.log(`   测试任务: ${s.testTask}`);
+        console.error(`${i + 1}. ${s.message}`);
+        console.error(`   开发任务: ${s.developTask.file}`);
+        console.error(`   测试任务: ${s.testTask}`);
       });
     } else {
-      console.log('✅ 无待处理的流转建议');
+      console.error('✅ 无待处理的流转建议');
     }
   } else {
     main();

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

@@ -14,6 +14,12 @@ const fs = require('fs');
 const path = require('path');
 
 const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// 如果不在 Claude Code 环境中运行，静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
 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');
@@ -110,8 +116,8 @@ function main() {
 
       // 输出验证提示（仅在非 PostToolUse 事件，避免重复）
       if (eventType !== 'PostToolUse') {
-        console.log(`\n🔍 [验证提醒] ${hint}`);
-        console.log(`使用 /verify-work 查看待验证任务列表\n`);
+        console.error(`\n🔍 [验证提醒] ${hint}`);
+        console.error(`使用 /verify-work 查看待验证任务列表\n`);
       }
     }
 
@@ -119,8 +125,8 @@ function main() {
     if (eventType === 'AgentStop') {
       const pending = getPendingVerifies();
       if (pending.length > 0) {
-        console.log(`\n🔍 [待验证任务] 还有 ${pending.length} 个任务待验证`);
-        console.log(`使用 /verify-work 查看详情并标记完成\n`);
+        console.error(`\n🔍 [待验证任务] 还有 ${pending.length} 个任务待验证`);
+        console.error(`使用 /verify-work 查看详情并标记完成\n`);
       }
     }
 

package/.claude/quality-gate.json

@@ -1,13 +1,19 @@
 {
   "enabled": true,
-  "severity": "warn",
+  "severity": "error",
   "rules": [
     {
       "id": "line-count-limit",
       "enabled": true,
-      "severity": "error",
+      "severity": "warn",
       "config": {
-        "maxLines": 800
+        "maxLines": 3000,
+        "exclude": [
+          "node_modules/**",
+          "package-lock.json",
+          ".claude/skills/**",
+          "lib/commands.js"
+        ]
       }
     },
     {

package/.claude/settings.local.json

@@ -90,7 +90,22 @@
       "Bash(npm view:*)",
       "Bash(npm update:*)",
       "Bash(ln:*)",
-      "Bash(git reset:*)"
+      "Bash(git reset:*)",
+      "Bash(echo:*)",
+      "Bash(bash:*)",
+      "Bash(find:*)",
+      "Bash(read:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(chelper --help:*)",
+      "Bash(chelper enter --help:*)",
+      "Bash(chelper enter:*)",
+      "Bash(chelper doctor:*)",
+      "Bash(claude mcp list:*)",
+      "Bash(claude:*)",
+      "WebFetch(domain:docs.bigmodel.cn)",
+      "WebFetch(domain:docs.z.ai)",
+      "Bash(CLAUDE_PROJECT_DIR=/Users/sumulige/Documents/Antigravity/talos node:*)",
+      "Bash(npm run test:coverage:*)"
     ]
   },
   "hooks": {

package/.claude/templates/hooks/README.md

@@ -0,0 +1,302 @@
+# Claude Code Hooks 模板库
+
+> 标准化 hook 开发，防止常见错误
+
+---
+
+## 📋 目录
+
+- [快速开始](#快速开始)
+- [Hook 类型](#hook-类型)
+- [最佳实践](#最佳实践)
+- [常见错误](#常见错误)
+- [检查清单](#检查清单)
+
+---
+
+## 🚀 快速开始
+
+### 1. 选择模板
+
+```bash
+# UserPromptSubmit hook (用户提交提示时触发)
+cp user-prompt-submit.cjs.template my-hook.cjs
+
+# UserResponseSubmit hook (AI 返回响应后触发)
+cp user-response-submit.cjs.template my-hook.cjs
+
+# Shell hook
+cp hook.sh.template my-hook.sh
+```
+
+### 2. 修改配置
+
+```javascript
+// 修改配置区域
+const CONFIG = {
+  enabled: true,
+  verbose: false,  // 开发时设为 true
+};
+```
+
+### 3. 实现逻辑
+
+在标记区域添加你的代码：
+
+```javascript
+// ===== 在这里实现你的 hook 逻辑 =====
+
+// 你的代码
+
+// ===== Hook 逻辑结束 =====
+```
+
+### 4. 测试
+
+```bash
+# 添加执行权限
+chmod +x my-hook.cjs
+
+# 测试（模拟环境变量）
+CLAUDE_PROJECT_DIR=/path/to/project node my-hook.cjs
+
+# 开启调试模式
+VERBOSE=true CLAUDE_PROJECT_DIR=/path/to/project node my-hook.cjs
+```
+
+---
+
+## 📦 Hook 类型
+
+### UserPromptSubmit
+
+用户每次提交提示时触发。
+
+**可用环境变量:**
+- `CLAUDE_PROJECT_DIR` - 项目根目录
+- `CLAUDE_TOOL_NAME` - 当前调用的工具名
+- `CLAUDE_TOOL_INPUT` - 工具输入内容
+
+**使用场景:**
+- 追踪用户操作
+- 记录工具调用
+- 触发自动化流程
+
+### UserResponseSubmit
+
+AI 返回响应后触发。
+
+**可用环境变量:**
+- `CLAUDE_PROJECT_DIR` - 项目根目录
+- `CLAUDE_RESPONSE_CONTENT` - 响应内容
+
+**使用场景:**
+- 分析响应内容
+- 统计 token 使用
+- 自动保存代码
+
+---
+
+## ✅ 最佳实践
+
+### 1. 环境变量处理
+
+```javascript
+// ✅ 正确 - 提供 fallback
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// ❌ 错误 - 直接使用可能 undefined
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR;
+```
+
+### 2. 静默退出
+
+```javascript
+// ✅ 正确 - 非项目环境时静默退出
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+
+// ❌ 错误 - 会抛出异常
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  throw new Error('No project dir');
+}
+```
+
+### 3. 错误处理
+
+```javascript
+// ✅ 正确 - 捕获所有错误
+try {
+  // 你的逻辑
+} catch (error) {
+  log('Error:', error.message);
+}
+
+// ❌ 错误 - 未捕获错误会显示给用户
+// 直接执行可能失败的操作
+```
+
+### 4. 文件操作
+
+```javascript
+// ✅ 正确 - 安全的文件操作
+function safeWriteFile(filePath, content) {
+  try {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+  } catch (e) {
+    return false;  // 静默失败
+  }
+}
+
+// ❌ 错误 - 可能因为目录不存在而失败
+fs.writeFileSync(filePath, content);
+```
+
+### 5. 输出控制
+
+```javascript
+// ✅ 正确 - 使用 stderr 记录日志
+function log(...args) {
+  console.error('[Hook]', ...args);
+}
+
+// ❌ 错误 - stdout 会干扰响应
+console.log(...args);
+```
+
+---
+
+## 🐛 常见错误
+
+### 错误 1: 未检查环境变量
+
+```javascript
+// ❌ 问题代码
+const dir = path.join(process.env.CLAUDE_PROJECT_DIR, 'subdir');
+
+// ✅ 修复
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+if (!process.env.CLAUDE_PROJECT_DIR) {
+  process.exit(0);
+}
+const dir = path.join(PROJECT_DIR, 'subdir');
+```
+
+### 错误 2: 未捕获异常
+
+```javascript
+// ❌ 问题代码
+function main() {
+  const data = JSON.parse(fs.readFileSync('data.json'));  // 文件不存在会崩溃
+}
+
+// ✅ 修复
+function main() {
+  try {
+    const data = JSON.parse(fs.readFileSync('data.json') || '{}');
+  } catch (e) {
+    // 静默处理
+  }
+}
+```
+
+### 错误 3: 输出到 stdout
+
+```javascript
+// ❌ 问题代码
+console.log('Processing...');  // 会出现在用户对话中
+
+// ✅ 修复
+function log(...args) {
+  if (CONFIG.verbose) {
+    console.error('[Hook]', ...args);  // stderr 不影响对话
+  }
+}
+```
+
+### 错误 4: 忘记退出码
+
+```javascript
+// ❌ 问题代码
+main();  // 可能返回非零退出码
+
+// ✅ 修复
+try {
+  main();
+} catch (e) {
+  // ...
+}
+process.exit(0);  // 始终返回成功
+```
+
+---
+
+## 📝 Hook 开发检查清单
+
+在提交新 hook 前，确保：
+
+- [ ] **环境变量**: 使用 `|| process.cwd()` 提供 fallback
+- [ ] **静默退出**: 非项目环境时 `process.exit(0)`
+- [ ] **错误处理**: 所有可能失败的操作都在 try-catch 中
+- [ ] **文件操作**: 使用安全函数，目录不存在时自动创建
+- [ ] **输出控制**: 调试信息使用 stderr，生产环境静默
+- [ ] **退出码**: 始终返回 0，不影响 Claude Code
+- [ ] **执行权限**: Shell hooks 有 `chmod +x`
+- [ ] **测试**: 在有/无 CLAUDE_PROJECT_DIR 环境下都测试过
+
+---
+
+## 🔧 调试技巧
+
+### 开启调试模式
+
+```bash
+# 临时开启
+VERBOSE=true CLAUDE_PROJECT_DIR=/path/to/project node my-hook.cjs
+
+# 或修改配置
+const CONFIG = {
+  verbose: true,  // 开启调试
+};
+```
+
+### 查看日志
+
+```bash
+# 追踪执行
+node my-hook.cjs 2>&1 | tee hook-debug.log
+
+# 检查退出码
+node my-hook.cjs; echo "Exit code: $?"
+```
+
+### 常用测试命令
+
+```bash
+# 模拟完整环境
+CLAUDE_PROJECT_DIR=$(pwd) \
+CLAUDE_TOOL_NAME=Edit \
+CLAUDE_TOOL_INPUT="test input" \
+node my-hook.cjs
+
+# 测试错误处理
+CLAUDE_PROJECT_DIR="" node my-hook.cjs
+```
+
+---
+
+## 📚 现有 Hooks 参考
+
+| Hook | 功能 | 关键技术 |
+|------|------|----------|
+| `todo-manager.cjs` | 任务管理 | 目录扫描、状态流转 |
+| `thinking-silent.cjs` | 对话追踪 | 静默执行、定期同步 |
+| `code-formatter.cjs` | 代码格式化 | 文件监听、外部调用 |
+| `multi-session.cjs` | 多会话管理 | 会话追踪、状态恢复 |
+
+---
+
+> **维护**: 添加新 hook 时，请基于模板创建并更新本文档