agent-configs 1.0.0

package/bundles/continuous-learning/.claude/hooks/learning-end.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Continuous Learning - Stop Hook
+ * 
+ * 触发时机：会话结束 (Stop hook)
+ * 功能：评估会话是否包含值得提取的 patterns
+ * 
+ * 为什么使用 Stop hook 而非 UserPromptSubmit:
+ * - Stop 只在会话结束时运行一次（轻量）
+ * - UserPromptSubmit 在每条消息时运行（增加延迟）
+ * - Stop 时有完整的会话上下文
+ */
+
+const path = require('path');
+
+// 使用本地 lib
+const libPath = path.join(__dirname, '..', 'lib');
+const { log, debug, getDateString } = require(path.join(libPath, 'utils'));
+const {
+  DEFAULT_CONFIG,
+  shouldEvaluateSession,
+  getLearningStatus,
+  ensureLearningDirs
+} = require(path.join(libPath, 'learning'));
+
+async function main() {
+  try {
+    // 确保目录存在
+    ensureLearningDirs();
+    
+    // 获取会话信息
+    const transcriptPath = process.env.CLAUDE_TRANSCRIPT_PATH || '';
+    const sessionId = process.env.CLAUDE_SESSION_ID || '';
+    
+    if (!transcriptPath) {
+      // 没有 transcript 信息，静默退出
+      process.exit(0);
+    }
+    
+    // 尝试读取 transcript 获取消息数
+    let messageCount = 0;
+    try {
+      const fs = require('fs');
+      if (fs.existsSync(transcriptPath)) {
+        const content = fs.readFileSync(transcriptPath, 'utf8');
+        // 简单计数 user 消息
+        const userMessages = (content.match(/"type"\s*:\s*"user"/g) || []).length;
+        messageCount = userMessages;
+      }
+    } catch {
+      // 无法读取 transcript
+    }
+    
+    // 检查是否应该评估
+    if (!shouldEvaluateSession(messageCount)) {
+      debug(`[ContinuousLearning] 会话较短 (${messageCount} 条消息)，跳过评估`);
+      process.exit(0);
+    }
+    
+    // 获取当前学习状态
+    const status = getLearningStatus();
+    
+    // 输出提示信息
+    log(`[ContinuousLearning] 会话包含 ${messageCount} 条消息`);
+    log(`[ContinuousLearning] 当前已学习: ${status.v1.learnedSkillsCount} 个 skills, ${status.v2.instinctsCount} 个 instincts`);
+    
+    // 如果有可进化的集群，提示用户
+    if (status.v2.evolvableClusters.length > 0) {
+      log(`[ContinuousLearning] 发现 ${status.v2.evolvableClusters.length} 个可进化的 instinct 集群`);
+      log(`[ContinuousLearning] 使用 /evolve 查看详情`);
+    }
+    
+    // 提示用户可以使用 /learn 提取 patterns
+    log(`[ContinuousLearning] 如果本次会话有值得保存的 patterns，可以运行 /learn`);
+    
+  } catch (err) {
+    debug(`[ContinuousLearning] Error: ${err.message}`);
+  }
+  
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});

package/bundles/continuous-learning/.claude/hooks/observe.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * Continuous Learning v2 - Observation Hook
+ * 
+ * 触发时机：PreToolUse / PostToolUse
+ * 功能：捕获工具使用事件，用于 pattern 分析
+ * 
+ * 为什么使用 hooks 而非 skills 进行观察:
+ * - Skills 是概率性的（~50-80% 触发率）
+ * - Hooks 是确定性的（100% 触发）
+ * - 这确保了不会遗漏任何 patterns
+ * 
+ * Hook 配置 (在 settings.json 中):
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [{
+ *       "matcher": "*",
+ *       "hooks": [{ "type": "command", "command": "node .claude/hooks/observe.js pre" }]
+ *     }],
+ *     "PostToolUse": [{
+ *       "matcher": "*",
+ *       "hooks": [{ "type": "command", "command": "node .claude/hooks/observe.js post" }]
+ *     }]
+ *   }
+ * }
+ */
+
+const path = require('path');
+
+// 使用本地 lib
+const libPath = path.join(__dirname, '..', 'lib');
+const { debug, truncate } = require(path.join(libPath, 'utils'));
+const {
+  DEFAULT_CONFIG,
+  recordObservation,
+  ensureLearningDirs
+} = require(path.join(libPath, 'learning'));
+
+// 获取 hook 类型参数
+const hookType = process.argv[2] || 'unknown';
+
+async function main() {
+  try {
+    // 确保目录存在
+    ensureLearningDirs();
+    
+    // 读取 stdin (Claude Code 通过 stdin 传递 hook 数据)
+    let inputData = '';
+    
+    // 设置超时，避免无限等待
+    const timeout = setTimeout(() => {
+      process.exit(0);
+    }, 1000);
+    
+    process.stdin.setEncoding('utf8');
+    
+    for await (const chunk of process.stdin) {
+      inputData += chunk;
+    }
+    
+    clearTimeout(timeout);
+    
+    if (!inputData.trim()) {
+      process.exit(0);
+    }
+    
+    // 解析输入
+    let hookData;
+    try {
+      hookData = JSON.parse(inputData);
+    } catch {
+      debug('[ContinuousLearning] 无法解析 hook 数据');
+      process.exit(0);
+    }
+    
+    // 提取相关字段
+    const toolName = hookData.tool_name || hookData.tool || 'unknown';
+    const toolInput = hookData.tool_input || hookData.input || {};
+    const toolOutput = hookData.tool_output || hookData.output || '';
+    const sessionId = hookData.session_id || process.env.CLAUDE_SESSION_ID || 'unknown';
+    
+    // 检查是否应该忽略此工具
+    const config = DEFAULT_CONFIG.v2;
+    if (config.observation.ignore_tools.includes(toolName)) {
+      // 透传原始数据
+      console.log(inputData);
+      process.exit(0);
+    }
+    
+    // 构建观察记录
+    const eventType = hookType === 'pre' ? 'tool_start' : 'tool_complete';
+    
+    const observation = {
+      event: eventType,
+      tool: toolName,
+      session: sessionId
+    };
+    
+    // 添加输入/输出（截断过长内容）
+    if (eventType === 'tool_start' && toolInput) {
+      observation.input = truncate(
+        typeof toolInput === 'string' ? toolInput : JSON.stringify(toolInput),
+        5000
+      );
+    }
+    
+    if (eventType === 'tool_complete' && toolOutput) {
+      observation.output = truncate(
+        typeof toolOutput === 'string' ? toolOutput : JSON.stringify(toolOutput),
+        5000
+      );
+    }
+    
+    // 记录观察
+    recordObservation(observation);
+    
+    // 透传原始数据（不阻塞 hook 链）
+    console.log(inputData);
+    
+  } catch (err) {
+    debug(`[ContinuousLearning] Observe error: ${err.message}`);
+    // 确保在错误时也透传数据
+    process.stdout.write(process.stdin.read() || '');
+  }
+  
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});