agent-configs 1.0.0

package/bundles/continuous-learning/.claude/lib/utils.js

@@ -0,0 +1,312 @@
+/**
+ * Continuous Learning - 自包含工具函数库
+ * 
+ * 这个文件包含所有需要的工具函数，不依赖任何外部模块。
+ * 可以直接复制整个 .claude 目录到任何项目使用。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// ============== 平台检测 ==============
+
+const isWindows = process.platform === 'win32';
+
+// ============== 目录工具 ==============
+
+/**
+ * 确保目录存在（递归创建）
+ */
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+  return dirPath;
+}
+
+// ============== 日期时间工具 ==============
+
+/**
+ * 获取当前日期 YYYY-MM-DD 格式
+ */
+function getDateString() {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}
+
+/**
+ * 获取当前时间 HH:MM:SS 格式
+ */
+function getTimeString() {
+  const now = new Date();
+  const hours = String(now.getHours()).padStart(2, '0');
+  const minutes = String(now.getMinutes()).padStart(2, '0');
+  const seconds = String(now.getSeconds()).padStart(2, '0');
+  return `${hours}:${minutes}:${seconds}`;
+}
+
+/**
+ * 获取 ISO 时间戳
+ */
+function getTimestamp() {
+  return new Date().toISOString();
+}
+
+/**
+ * 获取短会话 ID（从环境变量）
+ */
+function getSessionIdShort(fallback = 'default') {
+  const sessionId = process.env.CLAUDE_SESSION_ID;
+  if (!sessionId || sessionId.length === 0) {
+    return fallback;
+  }
+  return sessionId.slice(-8);
+}
+
+// ============== 文件操作 ==============
+
+/**
+ * 安全读取文件
+ */
+function readFile(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf8');
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 写入文件（自动创建目录）
+ */
+function writeFile(filePath, content) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+/**
+ * 追加到文件
+ */
+function appendFile(filePath, content) {
+  ensureDir(path.dirname(filePath));
+  fs.appendFileSync(filePath, content, 'utf8');
+}
+
+/**
+ * 追加 JSON 行到 jsonl 文件
+ */
+function appendJsonl(filePath, data) {
+  ensureDir(path.dirname(filePath));
+  fs.appendFileSync(filePath, JSON.stringify(data) + '\n', 'utf8');
+}
+
+/**
+ * 读取 jsonl 文件
+ */
+function readJsonl(filePath) {
+  const content = readFile(filePath);
+  if (!content) return [];
+  
+  return content
+    .split('\n')
+    .filter(line => line.trim())
+    .map(line => {
+      try {
+        return JSON.parse(line);
+      } catch {
+        return null;
+      }
+    })
+    .filter(Boolean);
+}
+
+/**
+ * 获取文件大小 (MB)
+ */
+function getFileSizeMB(filePath) {
+  try {
+    const stats = fs.statSync(filePath);
+    return stats.size / (1024 * 1024);
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * 查找匹配的文件
+ * @param {string} dir - 目录
+ * @param {string} pattern - 文件模式 (如 "*.md")
+ * @param {object} options - { maxAge: days }
+ */
+function findFiles(dir, pattern, options = {}) {
+  const { maxAge = null } = options;
+  const results = [];
+
+  if (!fs.existsSync(dir)) {
+    return results;
+  }
+
+  const regexPattern = pattern
+    .replace(/\./g, '\\.')
+    .replace(/\*/g, '.*')
+    .replace(/\?/g, '.');
+  const regex = new RegExp(`^${regexPattern}$`);
+
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+
+      if (entry.isFile() && regex.test(entry.name)) {
+        const stats = fs.statSync(fullPath);
+        
+        if (maxAge !== null) {
+          const ageInDays = (Date.now() - stats.mtimeMs) / (1000 * 60 * 60 * 24);
+          if (ageInDays <= maxAge) {
+            results.push({ path: fullPath, mtime: stats.mtimeMs });
+          }
+        } else {
+          results.push({ path: fullPath, mtime: stats.mtimeMs });
+        }
+      }
+    }
+  } catch {
+    // 忽略权限错误
+  }
+
+  // 按修改时间倒序排列
+  results.sort((a, b) => b.mtime - a.mtime);
+
+  return results;
+}
+
+// ============== 日志输出 ==============
+
+/**
+ * 输出到 stdout（Hook 输出需要使用 stdout 才能被用户看到）
+ * stderr 只在 --debug 模式下可见
+ */
+function log(message) {
+  console.log(message);
+}
+
+/**
+ * 输出到 stderr（调试信息）
+ */
+function debug(message) {
+  console.error(message);
+}
+
+// ============== 工作区检测 ==============
+
+/**
+ * 获取工作区根目录
+ */
+function getWorkspaceRoot() {
+  // 优先使用 Claude Code 提供的项目目录
+  if (process.env.CLAUDE_PROJECT_DIR) {
+    return process.env.CLAUDE_PROJECT_DIR;
+  }
+
+  // 尝试 git 根目录
+  try {
+    const gitRoot = execSync('git rev-parse --show-toplevel', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim();
+    if (gitRoot) return gitRoot;
+  } catch {
+    // 不是 git 仓库
+  }
+
+  // 回退到 PWD 或 cwd
+  return process.env.PWD || process.cwd();
+}
+
+/**
+ * 获取当前项目名称
+ */
+function getCurrentProject(workspace) {
+  const root = workspace || getWorkspaceRoot();
+  return path.basename(root);
+}
+
+/**
+ * 获取用户主目录
+ */
+function getHomeDir() {
+  return os.homedir();
+}
+
+/**
+ * 展开路径中的 ~
+ */
+function expandPath(p) {
+  if (p.startsWith('~')) {
+    return path.join(getHomeDir(), p.slice(1));
+  }
+  return p;
+}
+
+// ============== 字符串工具 ==============
+
+/**
+ * 将字符串转换为安全的文件名
+ */
+function toSafeFilename(str) {
+  return str
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+/**
+ * 截断字符串
+ */
+function truncate(str, maxLength) {
+  if (!str || str.length <= maxLength) return str;
+  return str.slice(0, maxLength) + '...';
+}
+
+module.exports = {
+  // 平台
+  isWindows,
+  
+  // 目录
+  ensureDir,
+  
+  // 日期时间
+  getDateString,
+  getTimeString,
+  getTimestamp,
+  getSessionIdShort,
+  
+  // 文件
+  readFile,
+  writeFile,
+  appendFile,
+  appendJsonl,
+  readJsonl,
+  getFileSizeMB,
+  findFiles,
+  
+  // 日志
+  log,
+  debug,
+  
+  // 工作区
+  getWorkspaceRoot,
+  getCurrentProject,
+  getHomeDir,
+  expandPath,
+  
+  // 字符串
+  toSafeFilename,
+  truncate
+};

package/bundles/continuous-learning/.claude/skills/continuous-learning/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: continuous-learning
+description: 持续学习能力 - 从会话中自动提取可复用的 patterns，保存为 skills 或 instincts，并支持进化为更高级结构。
+version: 2.0.0
+---
+
+# Continuous Learning - 持续学习
+
+## 这是什么
+
+这是一个让 AI 具备"学习意识"的能力。通过观察会话中的 patterns，将有价值的知识提取并保存，供未来会话使用。
+
+核心理念：**如果你不得不多次重复相同的提示，或者 Claude 遇到了同样的问题——这些 patterns 应该被保存下来。**
+
+## 架构概述
+
+```
+会话活动
+    │
+    │ Hooks 捕获提示 + 工具使用 (100% 可靠)
+    ▼
+┌─────────────────────────────────────────┐
+│         observations.jsonl              │
+│   (提示、工具调用、结果)                │
+└─────────────────────────────────────────┘
+    │
+    │ 会话结束时评估 / 手动 /learn
+    ▼
+┌─────────────────────────────────────────┐
+│            PATTERN 检测                 │
+│   • 用户纠正 → instinct/skill          │
+│   • 错误解决 → instinct/skill          │
+│   • 重复工作流 → instinct/skill        │
+└─────────────────────────────────────────┘
+    │
+    │ /evolve 聚合
+    ▼
+┌─────────────────────────────────────────┐
+│              evolved/                   │
+│   • commands/new-feature.md            │
+│   • skills/testing-workflow.md         │
+│   • agents/refactor-specialist.md      │
+└─────────────────────────────────────────┘
+```
+
+## 两个版本
+
+### v1: 简单版 - Learned Skills
+
+使用 Stop hook 在会话结束时评估，直接提取为完整 skills。
+
+**优点**: 简单直接，立即可用
+**适合**: 希望快速开始的用户
+
+```
+会话结束 → 评估 patterns → 保存到 ~/.claude/skills/learned/
+```
+
+### v2: 高级版 - Instincts + Evolution
+
+使用 PreToolUse/PostToolUse hooks 实时观察，创建原子级 "instincts"（带置信度），支持进化。
+
+**优点**: 更精细的学习，支持置信度衰减和进化
+**适合**: 希望深度定制的高级用户
+
+```
+工具使用 → 观察记录 → 创建 instincts → 聚合进化 → skills/commands/agents
+```
+
+## Pattern 类型
+
+| Pattern | 说明 |
+|---------|------|
+| `error_resolution` | 特定错误如何被解决 |
+| `user_corrections` | 用户纠正的行为 |
+| `workarounds` | 框架/库的变通方案 |
+| `debugging_techniques` | 有效的调试方法 |
+| `project_specific` | 项目特定的约定 |
+
+## Instinct 模型 (v2)
+
+一个 instinct 是一个小的、原子级的学习行为：
+
+```yaml
+---
+id: prefer-functional-style
+trigger: "when writing new functions"
+confidence: 0.7
+domain: "code-style"
+source: "session-observation"
+---
+
+# Prefer Functional Style
+
+## Action
+Use functional patterns over classes when appropriate.
+
+## Evidence
+- Observed 5 instances of functional pattern preference
+- User corrected class-based approach to functional on 2026-01-15
+```
+
+**特性**:
+- **原子级** — 一个触发器，一个动作
+- **置信度加权** — 0.3 = 尝试性, 0.9 = 近乎确定
+- **Domain 标签** — code-style, testing, git, debugging, workflow 等
+- **证据支持** — 记录创建它的观察
+
+## 置信度评分
+
+| 分数 | 含义 | 行为 |
+|------|------|------|
+| 0.3 | 尝试性 | 建议但不强制 |
+| 0.5 | 中等 | 在相关时应用 |
+| 0.7 | 强 | 自动批准应用 |
+| 0.9 | 近乎确定 | 核心行为 |
+
+**置信度增加**当:
+- Pattern 被重复观察
+- 用户不纠正建议的行为
+- 来自其他来源的类似 instincts 同意
+
+**置信度降低**当:
+- 用户明确纠正行为
+- Pattern 长时间未观察到
+- 出现矛盾证据
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/learn` | 手动提取当前会话的 patterns |
+| `/instinct-status` | 显示所有已学习的 instincts 及置信度 |
+| `/evolve` | 将相关 instincts 聚合为 skills/commands/agents |
+| `/instinct-export` | 导出 instincts 分享 |
+| `/instinct-import <file>` | 导入他人的 instincts |
+
+## 文件结构
+
+```
+~/.claude/
+├── skills/
+│   └── learned/                # v1: 直接学习的 skills
+│       ├── error-fix-xyz.md
+│       └── workaround-abc.md
+│
+└── homunculus/                 # v2: instinct-based 学习
+    ├── identity.json           # 你的档案、技术水平
+    ├── observations.jsonl      # 当前会话观察
+    ├── observations.archive/   # 处理过的观察
+    ├── instincts/
+    │   ├── personal/           # 自动学习的 instincts
+    │   └── inherited/          # 从他人导入的
+    └── evolved/
+        ├── agents/             # 生成的专业 agents
+        ├── skills/             # 生成的 skills
+        └── commands/           # 生成的 commands
+```
+
+## 何时建议学习
+
+在以下情况，**主动建议**用户运行 `/learn`：
+
+### 触发场景
+
+1. **解决了复杂的 bug**
+   - 调试过程超过 3 步
+   - 发现了非显而易见的根因
+   - 解决方案可能对其他项目有用
+
+2. **做出了重要的变通**
+   - 绕过了库/API 的限制
+   - 找到了版本兼容问题的解决方案
+
+3. **用户进行了纠正**
+   - 用户纠正了你的方法
+   - 用户指出了更好的做法
+
+4. **重复的工作流**
+   - 同样的步骤序列执行了多次
+   - 可以抽象为可复用的流程
+
+### 提醒方式
+
+```
+💡 这个解决方案看起来可能对其他项目有用。
+   想要保存为 skill 吗？运行 /learn
+```
+
+## 隐私
+
+- 观察记录**仅保存在本地**
+- 只有**instincts**（patterns）可以导出
+- 不会分享实际代码或对话内容
+- 你控制导出什么
+
+## 相关
+
+- [The Longform Guide](https://github.com/affaan-m/everything-claude-code) - Continuous learning 章节
+- [Homunculus](https://github.com/humanplane/homunculus) - v2 架构的灵感来源

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

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * Continuous Learning - Session End Hook for Cursor
+ * 
+ * Cursor 版本的会话结束 hook
+ * 功能与 Claude Code 版本相同，但路径引用适配 Cursor 结构
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// 简化的工具函数
+function log(message) {
+  console.log(message);
+}
+
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+function getDateString() {
+  const now = new Date();
+  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+}
+
+function expandPath(p) {
+  if (p.startsWith('~')) {
+    return path.join(os.homedir(), p.slice(1));
+  }
+  return p;
+}
+
+// 默认配置
+const MIN_SESSION_LENGTH = 10;
+const LEARNED_SKILLS_PATH = expandPath('~/.claude/skills/learned/');
+const HOMUNCULUS_PATH = expandPath('~/.claude/homunculus/');
+
+async function main() {
+  try {
+    // 确保目录存在
+    ensureDir(LEARNED_SKILLS_PATH);
+    ensureDir(HOMUNCULUS_PATH);
+    
+    // 获取会话信息
+    const transcriptPath = process.env.CURSOR_TRANSCRIPT_PATH || process.env.CLAUDE_TRANSCRIPT_PATH || '';
+    
+    if (!transcriptPath) {
+      process.exit(0);
+    }
+    
+    // 尝试读取 transcript 获取消息数
+    let messageCount = 0;
+    try {
+      if (fs.existsSync(transcriptPath)) {
+        const content = fs.readFileSync(transcriptPath, 'utf8');
+        const userMessages = (content.match(/"type"\s*:\s*"user"/g) || []).length;
+        messageCount = userMessages;
+      }
+    } catch {
+      // 无法读取 transcript
+    }
+    
+    // 检查是否应该评估
+    if (messageCount < MIN_SESSION_LENGTH) {
+      process.exit(0);
+    }
+    
+    // 统计已学习的内容
+    let skillsCount = 0;
+    let instinctsCount = 0;
+    
+    try {
+      if (fs.existsSync(LEARNED_SKILLS_PATH)) {
+        skillsCount = fs.readdirSync(LEARNED_SKILLS_PATH).filter(f => f.endsWith('.md')).length;
+      }
+    } catch {}
+    
+    try {
+      const instinctsPath = path.join(HOMUNCULUS_PATH, 'instincts', 'personal');
+      if (fs.existsSync(instinctsPath)) {
+        instinctsCount = fs.readdirSync(instinctsPath).filter(f => f.endsWith('.md')).length;
+      }
+    } catch {}
+    
+    // 输出提示信息
+    log(`[ContinuousLearning] 会话包含 ${messageCount} 条消息`);
+    log(`[ContinuousLearning] 当前已学习: ${skillsCount} 个 skills, ${instinctsCount} 个 instincts`);
+    log(`[ContinuousLearning] 如果本次会话有值得保存的 patterns，可以运行 /learn`);
+    
+  } catch (err) {
+    // 静默处理错误
+  }
+  
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});

package/bundles/continuous-learning/.cursor/rules/continuous-learning.mdc

@@ -0,0 +1,34 @@
+# 持续学习意识
+
+## 会话结束时
+
+当检测到以下情况时，建议用户使用 `/learn` 保存 patterns：
+
+- 解决了复杂的 bug（调试过程超过 3 步）
+- 做出了重要的变通方案
+- 用户进行了多次纠正
+- 同样的工作流重复执行了多次
+
+使用 `/learn` 提取可复用的 patterns。
+
+## 相关命令
+
+- `/learn` - 手动提取 patterns 为 skill
+- `/instinct-status` - 查看已学习的 instincts
+- `/evolve` - 将相关 instincts 进化为更高级结构
+
+## 学习系统说明
+
+本项目使用两层学习系统：
+
+### v1: Learned Skills
+- 直接保存到 `~/.claude/skills/learned/`
+- 完整的 pattern 描述
+- 适合明确的、可重用的解决方案
+
+### v2: Instincts
+- 保存到 `~/.claude/homunculus/instincts/`
+- 原子级学习单元，带置信度
+- 可进化为 skills/commands/agents
+
+建议在会话结束前，如果有值得保存的 patterns，主动提醒用户。