agent-configs 1.0.0

package/bundles/shared-memory/.claude/commands/save-session.md

@@ -0,0 +1,137 @@
+---
+name: save-session
+description: 保存当前会话的关键信息到记忆文件，便于下次继续。
+argument-hint: "[name]"
+---
+
+# Save Session Command
+
+保存当前会话状态到记忆文件，便于下次继续工作。
+
+## 用法
+
+```
+/save-session [name]
+```
+
+- **无参数**：使用默认名称 `session`，生成 `YYYY-MM-DD-session.md`
+- **有参数**：使用指定名称，生成 `YYYY-MM-DD-<name>.md`
+
+## 执行步骤
+
+执行此命令时，请按以下步骤操作：
+
+### 1. 分析当前会话
+
+回顾本次对话历史，识别以下内容：
+
+- 完成了哪些任务？
+- 正在进行什么工作？
+- 做出了哪些关键决策？为什么？
+- 遇到了什么问题？如何解决的？
+- 下次需要继续什么？
+- 哪些文件是重要的上下文？
+
+### 2. 生成记忆文件
+
+使用以下模板生成内容：
+
+```markdown
+# 会话: <简短描述>
+
+**日期**: YYYY-MM-DD HH:MM
+**项目**: <项目名称>
+**路径**: .claude/memory/sessions/YYYY-MM-DD-<name>.md
+**会话ID**: <当前会话短ID>
+
+## 已完成
+- [具体完成的任务1]
+- [具体完成的任务2]
+
+## 进行中
+- [任务] - 当前状态: [描述当前进度]
+
+## 关键决策
+- [决策1] - 原因: [为什么这样决定]
+- [决策2] - 原因: [为什么这样决定]
+
+## 遇到的问题
+- [问题1] - 解决方案: [如何解决的]
+
+## 下次继续
+- [ ] 待办1
+- [ ] 待办2
+
+## 需要加载的文件
+- `path/to/important/file.ts` - [为什么需要这个文件]
+
+## 相关上下文
+[任何额外的重要背景信息，比如特殊的项目约束、用户偏好等]
+```
+
+### 3. 保存文件
+
+将生成的内容保存到：
+
+```
+.claude/memory/sessions/YYYY-MM-DD-<name>.md
+```
+
+如果目录不存在，先创建目录结构。
+
+### 4. 确认保存
+
+向用户确认保存成功，并提示如何引用：
+
+```
+✅ 会话已保存到：.claude/memory/sessions/2026-01-27-feature-auth.md
+
+下次可以通过以下方式恢复：
+- `/load-session feature-auth`
+- `/load-session 1` (如果是最近的)
+- 直接 `@.claude/memory/sessions/2026-01-27-feature-auth.md`
+```
+
+## 示例
+
+### 用户调用
+
+```
+/save-session feature-auth
+```
+
+### AI 执行
+
+1. 分析对话，发现本次会话：
+   - 实现了用户认证模块
+   - 选择了 JWT 方案而非 Session
+   - 遇到了 token 刷新问题并解决
+   - 还需要完成权限校验中间件
+
+2. 生成并保存文件
+
+3. 返回确认：
+
+```
+✅ 会话已保存到：.claude/memory/sessions/2026-01-27-feature-auth.md
+
+本次记录了：
+- ✓ 完成用户认证模块实现
+- ✓ JWT vs Session 的技术决策
+- ✓ Token 刷新问题的解决方案
+- → 下次继续：权限校验中间件
+
+下次可以用 `/load-session feature-auth` 或 `@.claude/memory/sessions/2026-01-27-feature-auth.md` 恢复上下文。
+```
+
+## 注意事项
+
+1. **内容要精炼**：只记录关键信息，不要复制大段代码
+2. **决策要说明原因**：不只记录"选了什么"，还要记录"为什么选"
+3. **待办要具体**：不要写"继续开发"，要写"实现权限校验中间件"
+4. **文件路径要准确**：确保引用的文件路径是正确的
+
+## 相关命令
+
+- `/load-session` - 加载之前保存的会话
+- `/list-sessions` - 列出所有可用的会话记忆

package/bundles/shared-memory/.claude/hooks/memory-compact.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * Memory PreCompact Hook - 上下文压缩前提醒
+ * 
+ * 触发时机：上下文即将压缩
+ * 功能：提醒用户保存重要信息
+ */
+
+const path = require('path');
+
+// 使用本地 lib（相对于 .claude 目录）
+const libPath = path.join(__dirname, '..', 'lib');
+const { getMemoryDir } = require(path.join(libPath, 'memory'));
+const { log, appendFile, getWorkspaceRoot } = require(path.join(libPath, 'utils'));
+
+async function main() {
+  try {
+    const workspace = getWorkspaceRoot();
+    
+    // 记录压缩事件
+    const memoryDir = getMemoryDir(workspace);
+    const logFile = path.join(memoryDir, 'compaction-log.txt');
+    const timestamp = new Date().toISOString();
+    
+    try {
+      appendFile(logFile, `[${timestamp}] Context compaction triggered\n`);
+    } catch {
+      // 忽略写入失败
+    }
+
+    // 提醒用户保存
+    log(`[Memory] 上下文即将压缩，建议先 /save-session 保存关键进展`);
+
+  } catch (err) {
+    // 静默处理错误
+  }
+
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});

package/bundles/shared-memory/.claude/hooks/memory-end.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * Memory SessionEnd Hook - 会话结束时提醒保存
+ * 
+ * 触发时机：会话结束
+ * 功能：提醒用户保存重要进展
+ */
+
+const path = require('path');
+
+// 使用本地 lib（相对于 .claude 目录）
+const libPath = path.join(__dirname, '..', 'lib');
+const { getSessionsMemoryDir } = require(path.join(libPath, 'memory'));
+const { log, findFiles, getDateString, getWorkspaceRoot } = require(path.join(libPath, 'utils'));
+
+async function main() {
+  try {
+    const workspace = getWorkspaceRoot();
+    const sessionsDir = getSessionsMemoryDir(workspace);
+    const today = getDateString();
+
+    // 检查今天是否已经保存过记忆
+    const todayMemories = findFiles(sessionsDir, `${today}-*.md`);
+    
+    if (todayMemories.length > 0) {
+      // 今天已保存 - 不需要提醒
+      process.exit(0);
+    }
+
+    // 今天没有保存 - 提醒用户
+    log(`[Memory] 会话结束。如有重要进展，建议运行 /save-session 保存`);
+
+  } catch (err) {
+    // 静默处理错误
+  }
+
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});

package/bundles/shared-memory/.claude/hooks/memory-start.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * Memory SessionStart Hook - 检查可用的会话记忆
+ * 
+ * 触发时机：新会话开始
+ * 功能：检测并提示用户有可用的历史记忆
+ */
+
+const path = require('path');
+
+// 使用本地 lib（相对于 .claude 目录）
+const libPath = path.join(__dirname, '..', 'lib');
+const { checkMemoryStatus } = require(path.join(libPath, 'memory'));
+const { log, getWorkspaceRoot } = require(path.join(libPath, 'utils'));
+
+async function main() {
+  try {
+    const workspace = getWorkspaceRoot();
+    const status = checkMemoryStatus(workspace);
+
+    if (!status.exists) {
+      // 没有记忆目录 - 新项目正常情况
+      process.exit(0);
+    }
+
+    if (status.count === 0) {
+      // 有目录但没有最近的记忆
+      process.exit(0);
+    }
+
+    // 发现最近的记忆 - 通过 JSON 格式注入系统提示
+    let message = `📝 检测到 ${status.count} 个最近的会话记忆`;
+
+    if (status.latest) {
+      message += `\n   最近: ${status.latest.relativePath}`;
+    }
+
+    if (status.count === 1) {
+      message += `\n   💡 使用 /load-session 加载，或直接 @ 引用`;
+    } else {
+      message += `\n   💡 使用 /list-sessions 查看，/load-session 加载`;
+    }
+
+    // 输出 JSON 格式
+    // SessionStart 只支持 systemMessage 字段显示给用户
+    console.log(JSON.stringify({
+      systemMessage: message
+    }))
+
+  } catch (err) {
+    // 静默处理错误 - 记忆功能是可选的
+  }
+
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.exit(0);
+});

package/bundles/shared-memory/.claude/lib/memory.js

@@ -0,0 +1,416 @@
+/**
+ * Shared Memory - 记忆管理核心模块
+ * 
+ * 提供会话记忆的存储、检索、解析功能
+ */
+
+const fs = require('fs');
+const path = require('path');
+const {
+  ensureDir,
+  findFiles,
+  readFile,
+  writeFile,
+  getDateString,
+  getTimeString,
+  getSessionIdShort,
+  getWorkspaceRoot,
+  getCurrentProject
+} = require('./utils');
+
+// 默认配置
+const DEFAULT_CONFIG = {
+  storage: {
+    base_path: '.claude/memory/',
+    sessions_dir: 'sessions/',
+    context_file: 'context.md',
+    max_session_age_days: 30,
+    max_sessions_to_show: 10
+  }
+};
+
+// ============== 路径管理 ==============
+
+/**
+ * 获取记忆基础目录
+ */
+function getMemoryDir(workspace) {
+  const root = workspace || getWorkspaceRoot();
+  return path.join(root, DEFAULT_CONFIG.storage.base_path);
+}
+
+/**
+ * 获取会话记忆目录
+ */
+function getSessionsMemoryDir(workspace) {
+  return path.join(getMemoryDir(workspace), DEFAULT_CONFIG.storage.sessions_dir);
+}
+
+/**
+ * 获取项目上下文文件路径
+ */
+function getContextFile(workspace) {
+  return path.join(getMemoryDir(workspace), DEFAULT_CONFIG.storage.context_file);
+}
+
+/**
+ * 确保记忆目录存在
+ */
+function ensureMemoryDir(workspace) {
+  ensureDir(getMemoryDir(workspace));
+  ensureDir(getSessionsMemoryDir(workspace));
+}
+
+// ============== 文件名处理 ==============
+
+/**
+ * 生成会话文件名
+ * @param {string} name - 会话名称
+ * @returns {string} 格式: YYYY-MM-DD-<name>.md
+ */
+function generateSessionFilename(name) {
+  const date = getDateString();
+  const safeName = name
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')  // 支持中文
+    .replace(/^-+|-+$/g, '');
+  return `${date}-${safeName || 'session'}.md`;
+}
+
+/**
+ * 解析会话文件名
+ * @param {string} filename - 不含扩展名的文件名
+ * @returns {{date: string, name: string}}
+ */
+function parseSessionFilename(filename) {
+  const match = filename.match(/^(\d{4}-\d{2}-\d{2})-(.+)$/);
+  if (match) {
+    return { date: match[1], name: match[2] };
+  }
+  return { date: '', name: filename };
+}
+
+// ============== 记忆文件解析 ==============
+
+/**
+ * 解析记忆文件内容提取元数据
+ * @param {string} filePath - 文件路径
+ * @returns {object} 元数据
+ */
+function parseMemoryFile(filePath) {
+  const content = readFile(filePath);
+  if (!content) return {};
+
+  const metadata = {
+    title: '',
+    project: '',
+    sessionId: '',
+    status: 'unknown',
+    hasInProgress: false,
+    hasTodos: false
+  };
+
+  // 提取标题
+  const titleMatch = content.match(/^#\s+会话:\s*(.+)$/m);
+  if (titleMatch) {
+    metadata.title = titleMatch[1].trim();
+  }
+
+  // 提取项目
+  const projectMatch = content.match(/\*\*项目\*\*:\s*(.+)$/m);
+  if (projectMatch) {
+    metadata.project = projectMatch[1].trim();
+  }
+
+  // 提取会话 ID
+  const sessionIdMatch = content.match(/\*\*会话ID\*\*:\s*(.+)$/m);
+  if (sessionIdMatch) {
+    metadata.sessionId = sessionIdMatch[1].trim();
+  }
+
+  // 检查进行中项目
+  metadata.hasInProgress = /##\s+进行中/.test(content) && 
+    content.includes('- [') && 
+    !/##\s+进行中\s*\n+(?:##|\*\*|$)/.test(content);
+
+  // 检查待办事项
+  metadata.hasTodos = /##\s+下次继续/.test(content) &&
+    /- \[ \]/.test(content);
+
+  // 判断状态
+  if (metadata.hasInProgress || metadata.hasTodos) {
+    metadata.status = '进行中';
+  } else {
+    metadata.status = '已完成';
+  }
+
+  return metadata;
+}
+
+// ============== 记忆列表 ==============
+
+/**
+ * 列出所有会话记忆文件
+ * @param {object} options - { maxAge: days, limit: number, workspace: string }
+ * @returns {Array} 记忆列表
+ */
+function listSessionMemories(options = {}) {
+  const {
+    maxAge = DEFAULT_CONFIG.storage.max_session_age_days,
+    limit = DEFAULT_CONFIG.storage.max_sessions_to_show,
+    workspace
+  } = options;
+
+  const sessionsDir = getSessionsMemoryDir(workspace);
+  const files = findFiles(sessionsDir, '*.md', { maxAge });
+
+  return files.slice(0, limit).map(file => {
+    const filename = path.basename(file.path, '.md');
+    const parsed = parseSessionFilename(filename);
+    const metadata = parseMemoryFile(file.path);
+    
+    return {
+      path: file.path,
+      relativePath: `.claude/memory/sessions/${path.basename(file.path)}`,
+      mtime: file.mtime,
+      filename,
+      ...parsed,
+      ...metadata
+    };
+  });
+}
+
+/**
+ * 获取最近的记忆
+ */
+function getLatestMemory(workspace) {
+  const memories = listSessionMemories({ limit: 1, workspace });
+  return memories.length > 0 ? memories[0] : null;
+}
+
+/**
+ * 按名称查找记忆（模糊匹配）
+ * @param {string} query - 查询（名称或序号）
+ */
+function findMemoryByName(query, workspace) {
+  const memories = listSessionMemories({ workspace, limit: 100 });
+
+  // 数字则按索引
+  const num = parseInt(query, 10);
+  if (!isNaN(num) && num > 0 && num <= memories.length) {
+    return memories[num - 1];
+  }
+
+  // 模糊匹配
+  const queryLower = query.toLowerCase();
+  return memories.find(m => 
+    m.name.toLowerCase().includes(queryLower) ||
+    m.filename.toLowerCase().includes(queryLower) ||
+    (m.title && m.title.toLowerCase().includes(queryLower))
+  ) || null;
+}
+
+// ============== 记忆内容生成 ==============
+
+/**
+ * 生成记忆文件内容
+ * @param {object} data - 记忆数据
+ * @returns {string} Markdown 内容
+ */
+function generateMemoryContent(data) {
+  const {
+    title = '会话记录',
+    project = getCurrentProject(),
+    sessionId = getSessionIdShort(),
+    completed = [],
+    inProgress = [],
+    decisions = [],
+    problems = [],
+    todos = [],
+    filesToLoad = [],
+    context = ''
+  } = data;
+
+  const date = getDateString();
+  const time = getTimeString();
+  const filename = generateSessionFilename(title);
+
+  return `# 会话: ${title}
+
+**日期**: ${date} ${time}
+**项目**: ${project}
+**路径**: .claude/memory/sessions/${filename}
+**会话ID**: ${sessionId}
+
+## 已完成
+${completed.length > 0 ? completed.map(item => `- ${item}`).join('\n') : '- (无)'}
+
+## 进行中
+${inProgress.length > 0 ? inProgress.map(item => `- ${item}`).join('\n') : '- (无)'}
+
+## 关键决策
+${decisions.length > 0 ? decisions.map(item => `- ${item}`).join('\n') : '- (无)'}
+
+## 遇到的问题
+${problems.length > 0 ? problems.map(item => `- ${item}`).join('\n') : '- (无)'}
+
+## 下次继续
+${todos.length > 0 ? todos.map(item => `- [ ] ${item}`).join('\n') : '- [ ] (待定)'}
+
+## 需要加载的文件
+${filesToLoad.length > 0 ? filesToLoad.map(item => `- \`${item}\``).join('\n') : '- (无)'}
+
+## 相关上下文
+${context || '(无额外上下文)'}
+`;
+}
+
+// ============== 记忆保存/加载 ==============
+
+/**
+ * 保存会话记忆
+ * @param {object} data - 记忆数据
+ * @param {string} [workspace] - 工作区路径
+ */
+function saveSessionMemory(data, workspace) {
+  try {
+    ensureMemoryDir(workspace);
+    
+    const content = generateMemoryContent(data);
+    const filename = generateSessionFilename(data.title || 'session');
+    const filePath = path.join(getSessionsMemoryDir(workspace), filename);
+    
+    writeFile(filePath, content);
+    
+    return {
+      success: true,
+      path: filePath,
+      relativePath: `.claude/memory/sessions/${filename}`,
+      filename
+    };
+  } catch (err) {
+    return {
+      success: false,
+      error: err.message
+    };
+  }
+}
+
+/**
+ * 加载会话记忆
+ * @param {string} pathOrQuery - 文件路径、名称或索引
+ */
+function loadSessionMemory(pathOrQuery, workspace) {
+  try {
+    let filePath;
+    
+    // 直接路径
+    if (pathOrQuery.endsWith('.md') && fs.existsSync(pathOrQuery)) {
+      filePath = pathOrQuery;
+    } else {
+      // 按名称/索引查找
+      const memory = findMemoryByName(pathOrQuery, workspace);
+      if (!memory) {
+        return { success: false, error: `未找到匹配的记忆文件: ${pathOrQuery}` };
+      }
+      filePath = memory.path;
+    }
+
+    const content = readFile(filePath);
+    if (!content) {
+      return { success: false, error: `无法读取文件: ${filePath}` };
+    }
+
+    const metadata = parseMemoryFile(filePath);
+    
+    return {
+      success: true,
+      path: filePath,
+      relativePath: `.claude/memory/sessions/${path.basename(filePath)}`,
+      content,
+      metadata
+    };
+  } catch (err) {
+    return { success: false, error: err.message };
+  }
+}
+
+// ============== 状态检查 ==============
+
+/**
+ * 检查记忆目录状态
+ */
+function checkMemoryStatus(workspace) {
+  const memoryDir = getMemoryDir(workspace);
+  
+  if (!fs.existsSync(memoryDir)) {
+    return { exists: false, count: 0, latest: null };
+  }
+
+  const memories = listSessionMemories({ workspace, maxAge: 7 });
+  
+  return {
+    exists: true,
+    count: memories.length,
+    latest: memories.length > 0 ? memories[0] : null
+  };
+}
+
+// ============== 格式化输出 ==============
+
+/**
+ * 格式化记忆列表为表格
+ */
+function formatMemoriesList(memories) {
+  if (memories.length === 0) {
+    return '暂无会话记忆。使用 `/save-session <名称>` 保存当前会话。';
+  }
+
+  let output = '## 可用会话记忆\n\n';
+  output += '| # | 日期 | 名称 | 状态 | 路径 |\n';
+  output += '|---|------|------|------|------|\n';
+
+  memories.forEach((m, idx) => {
+    output += `| ${idx + 1} | ${m.date} | ${m.name} | ${m.status} | ${m.relativePath} |\n`;
+  });
+
+  output += '\n💡 使用方式：\n';
+  output += '- `/load-session <#>` 或 `/load-session <名称>` 加载\n';
+  output += '- 直接 `@.claude/memory/sessions/<文件名>` 引用\n';
+
+  return output;
+}
+
+module.exports = {
+  // 路径
+  getMemoryDir,
+  getSessionsMemoryDir,
+  getContextFile,
+  ensureMemoryDir,
+  
+  // 文件名
+  generateSessionFilename,
+  parseSessionFilename,
+  
+  // 解析
+  parseMemoryFile,
+  
+  // 列表
+  listSessionMemories,
+  getLatestMemory,
+  findMemoryByName,
+  
+  // 内容
+  generateMemoryContent,
+  
+  // 操作
+  saveSessionMemory,
+  loadSessionMemory,
+  checkMemoryStatus,
+  
+  // 格式化
+  formatMemoriesList,
+  
+  // 配置
+  DEFAULT_CONFIG
+};