agent-configs 1.0.0

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

@@ -0,0 +1,209 @@
+/**
+ * Shared Memory - 自包含工具函数库
+ * 
+ * 这个文件包含所有需要的工具函数，不依赖任何外部模块。
+ * 可以直接复制整个 .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 格式
+ */
+function getTimeString() {
+  const now = new Date();
+  const hours = String(now.getHours()).padStart(2, '0');
+  const minutes = String(now.getMinutes()).padStart(2, '0');
+  return `${hours}:${minutes}`;
+}
+
+/**
+ * 获取短会话 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');
+}
+
+/**
+ * 查找匹配的文件
+ * @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);
+}
+
+// ============== 工作区检测 ==============
+
+/**
+ * 获取工作区根目录
+ */
+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);
+}
+
+module.exports = {
+  // 平台
+  isWindows,
+  
+  // 目录
+  ensureDir,
+  
+  // 日期时间
+  getDateString,
+  getTimeString,
+  getSessionIdShort,
+  
+  // 文件
+  readFile,
+  writeFile,
+  appendFile,
+  findFiles,
+  
+  // 日志
+  log,
+  
+  // 工作区
+  getWorkspaceRoot,
+  getCurrentProject
+};

package/bundles/shared-memory/.claude/skills/shared-memory/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: shared-memory
+description: 跨会话记忆管理能力。让 AI 具备记忆保存和加载的意识，在适当时机主动提醒用户保存重要信息或建议加载相关上下文。使用场景：完成重要任务、做出关键决策、解决复杂问题、对话较长、用户结束工作时。
+version: 1.0.0
+---
+
+# Shared Memory - 跨会话记忆管理
+
+## 这是什么
+
+这是一个让你具备"记忆管理意识"的能力。作为 AI 助手，你应该：
+
+1. **意识到上下文的有限性** - 知道会话会结束，重要信息需要保存
+2. **主动提醒保存** - 在适当时机提醒用户保存进度
+3. **知道如何加载上下文** - 新会话开始时，引导用户加载相关记忆
+
+## 记忆文件位置
+
+所有记忆文件存储在**项目级目录**，便于直接 `@` 引用：
+
+```
+<项目根目录>/
+└── .claude/
+    └── memory/
+        ├── context.md                      # 项目持久上下文（长期）
+        └── sessions/
+            ├── 2026-01-27-feature-auth.md  # 会话记忆
+            ├── 2026-01-26-bug-fix.md
+            └── ...
+```
+
+**用户可以直接使用**：`@.claude/memory/sessions/2026-01-27-feature-auth.md`
+
+---
+
+## 何时提醒保存
+
+在以下情况，**主动建议**用户保存会话：
+
+### 触发场景
+
+1. **完成重要任务或里程碑**
+   - 完成了一个功能实现
+   - 完成了一轮重构
+   - 解决了一个复杂 bug
+
+2. **做出关键技术决策**
+   - 选择了某个技术方案
+   - 确定了架构设计
+   - 做出了重要的权衡取舍
+
+3. **解决了复杂问题**
+   - 调试了一个棘手的问题
+   - 发现了重要的 root cause
+   - 找到了有效的解决方案
+
+4. **对话较长（接近上下文限制）**
+   - 感觉到对话历史很长
+   - 已经讨论了很多内容
+   - 上下文可能快要压缩
+
+5. **用户表示要结束工作**
+   - "今天先到这里"
+   - "我要下班了"
+   - "明天继续"
+   - "先休息一下"
+
+### 提醒方式
+
+```
+💡 建议保存当前进度：
+
+/save-session <简短描述>
+
+这样下次可以继续，不会丢失上下文。
+```
+
+或更简洁：
+
+```
+💡 进展不错！建议 `/save-session feature-auth` 保存进度。
+```
+
+---
+
+## 何时建议加载
+
+在以下情况，**询问是否需要**加载之前的记忆：
+
+### 触发场景
+
+1. **会话刚开始时**
+   - 如果 Hook 提示有可用记忆
+   - 主动询问是否需要加载
+
+2. **用户提到"继续之前的工作"**
+   - "继续昨天的"
+   - "接着上次的做"
+   - "上次做到哪了"
+
+3. **用户提及之前讨论的内容**
+   - "之前那个 bug"
+   - "我们讨论过的那个方案"
+   - "上次的决定"
+
+### 询问方式
+
+```
+我注意到有之前的会话记忆，需要我加载吗？
+
+- 使用 `/list-sessions` 查看所有记忆
+- 使用 `/load-session <名称>` 加载特定记忆
+- 或直接 `@.claude/memory/sessions/xxx.md` 引用
+```
+
+---
+
+## 记忆文件格式
+
+保存的记忆文件应包含以下结构化信息：
+
+```markdown
+# 会话: <简短描述>
+
+**日期**: YYYY-MM-DD HH:MM
+**项目**: <项目名称>
+**路径**: .claude/memory/sessions/YYYY-MM-DD-<name>.md
+**会话ID**: <短ID>
+
+## 已完成
+- [具体完成的任务]
+
+## 进行中
+- [正在进行的任务] - 当前状态: [描述]
+
+## 关键决策
+- [决策] - 原因: [为什么这样决定]
+
+## 遇到的问题
+- [问题] - 解决方案: [如何解决的]
+
+## 下次继续
+- [ ] 待办事项1
+- [ ] 待办事项2
+
+## 需要加载的文件
+- `path/to/file` - [为什么需要]
+
+## 相关上下文
+[任何额外的重要背景信息]
+```
+
+---
+
+## 相关命令
+
+| 命令 | 说明 |
+|------|------|
+| `/save-session [name]` | 保存当前会话状态 |
+| `/load-session [name]` | 加载指定会话记忆 |
+| `/list-sessions` | 列出所有可用的会话记忆 |
+
+---
+
+## 最佳实践
+
+### 保存时机
+
+- **宁可多保存**：不确定是否需要保存时，建议保存
+- **有意义的命名**：使用描述性名称，如 `feature-auth`、`bug-fix-login`
+- **及时保存**：完成阶段性工作后立即保存
+
+### 加载时机
+
+- **按需加载**：不要主动读取所有记忆，让用户选择
+- **展示摘要**：加载后先展示摘要，确认是否需要深入
+- **提示相关文件**：如果记忆中有"需要加载的文件"，询问是否读取
+
+### 与用户协作
+
+- **不要过度打扰**：不是每次对话都需要提醒保存
+- **尊重用户选择**：用户拒绝保存时不要反复提醒
+- **主动但不强制**：建议是建议，最终由用户决定

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

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * Session Memory Start Hook for Cursor
+ * 
+ * Checks for recent session memory files and outputs a reminder.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const MEMORY_DIR = path.join(process.cwd(), '.claude', 'memory', 'sessions');
+
+function findRecentSessions(dir, maxAgeDays = 7) {
+  if (!fs.existsSync(dir)) return [];
+  
+  const now = Date.now();
+  const maxAge = maxAgeDays * 24 * 60 * 60 * 1000;
+  
+  return fs.readdirSync(dir)
+    .filter(f => f.endsWith('.md'))
+    .map(f => {
+      const fullPath = path.join(dir, f);
+      const stat = fs.statSync(fullPath);
+      return { name: f, path: fullPath, mtime: stat.mtime.getTime() };
+    })
+    .filter(f => now - f.mtime < maxAge)
+    .sort((a, b) => b.mtime - a.mtime);
+}
+
+function main() {
+  const sessions = findRecentSessions(MEMORY_DIR);
+  
+  if (sessions.length > 0) {
+    const latest = sessions[0];
+    console.error(`【会话记忆提示 - 请在回复开头告知用户】`);
+    console.error(`📝 检测到 ${sessions.length} 个最近的会话记忆`);
+    console.error(`   最近: ${latest.path}`);
+    console.error(`   💡 使用 /list-sessions 查看，/load-session 加载`);
+  }
+}
+
+main();

package/bundles/shared-memory/.cursor/rules/shared-memory.mdc

@@ -0,0 +1,37 @@
+---
+description: 跨会话记忆管理 - 在会话开始时检查历史记忆
+globs: 
+alwaysApply: true
+---
+
+# 跨会话记忆管理
+
+## 会话开始时（重要）
+
+当你收到包含「会话记忆提示」的 additional_context 时，**必须在回复的最开头**输出该提示内容，格式如下：
+
+```
+📝 检测到 X 个最近的会话记忆
+   最近: .claude/memory/sessions/xxx.md
+   💡 使用 /list-sessions 查看，/load-session 加载
+```
+
+然后再回答用户的问题。
+
+如果用户的问题与之前的工作相关，主动建议加载相关记忆。
+
+## 会话结束时
+
+当检测到以下情况时，建议用户保存记忆：
+- 完成了重要的功能实现
+- 做出了关键的技术决策
+- 解决了复杂的问题
+- 对话较长且包含有价值的上下文
+
+使用 `/save-session <name>` 保存会话。
+
+## 相关命令
+
+- `/save-session <name>` - 保存当前会话
+- `/load-session [name]` - 加载历史会话
+- `/list-sessions` - 列出所有可用记忆

package/bundles/shared-memory/.cursor/skills/shared-memory/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: shared-memory
+description: 跨会话记忆管理能力。让 AI 具备记忆保存和加载的意识，在适当时机主动提醒用户保存重要信息或建议加载相关上下文。使用场景：完成重要任务、做出关键决策、解决复杂问题、对话较长、用户结束工作时。
+version: 1.0.0
+---
+
+# Shared Memory - 跨会话记忆管理
+
+## 这是什么
+
+这是一个让你具备"记忆管理意识"的能力。作为 AI 助手，你应该：
+
+1. **意识到上下文的有限性** - 知道会话会结束，重要信息需要保存
+2. **主动提醒保存** - 在适当时机提醒用户保存进度
+3. **知道如何加载上下文** - 新会话开始时，引导用户加载相关记忆
+
+## 记忆文件位置
+
+所有记忆文件存储在**项目级目录**，便于直接 `@` 引用：
+
+```
+<项目根目录>/
+└── .claude/
+    └── memory/
+        ├── context.md                      # 项目持久上下文（长期）
+        └── sessions/
+            ├── 2026-01-27-feature-auth.md  # 会话记忆
+            ├── 2026-01-26-bug-fix.md
+            └── ...
+```
+
+**用户可以直接使用**：`@.claude/memory/sessions/2026-01-27-feature-auth.md`
+
+---
+
+## 何时提醒保存
+
+在以下情况，**主动建议**用户保存会话：
+
+### 触发场景
+
+1. **完成重要任务或里程碑**
+   - 完成了一个功能实现
+   - 完成了一轮重构
+   - 解决了一个复杂 bug
+
+2. **做出关键技术决策**
+   - 选择了某个技术方案
+   - 确定了架构设计
+   - 做出了重要的权衡取舍
+
+3. **解决了复杂问题**
+   - 调试了一个棘手的问题
+   - 发现了重要的 root cause
+   - 找到了有效的解决方案
+
+4. **对话较长（接近上下文限制）**
+   - 感觉到对话历史很长
+   - 已经讨论了很多内容
+   - 上下文可能快要压缩
+
+5. **用户表示要结束工作**
+   - "今天先到这里"
+   - "我要下班了"
+   - "明天继续"
+   - "先休息一下"
+
+### 提醒方式
+
+```
+💡 建议保存当前进度：
+
+/save-session <简短描述>
+
+这样下次可以继续，不会丢失上下文。
+```
+
+或更简洁：
+
+```
+💡 进展不错！建议 `/save-session feature-auth` 保存进度。
+```
+
+---
+
+## 何时建议加载
+
+在以下情况，**询问是否需要**加载之前的记忆：
+
+### 触发场景
+
+1. **会话刚开始时**
+   - 如果 Hook 提示有可用记忆
+   - 主动询问是否需要加载
+
+2. **用户提到"继续之前的工作"**
+   - "继续昨天的"
+   - "接着上次的做"
+   - "上次做到哪了"
+
+3. **用户提及之前讨论的内容**
+   - "之前那个 bug"
+   - "我们讨论过的那个方案"
+   - "上次的决定"
+
+### 询问方式
+
+```
+我注意到有之前的会话记忆，需要我加载吗？
+
+- 使用 `/list-sessions` 查看所有记忆
+- 使用 `/load-session <名称>` 加载特定记忆
+- 或直接 `@.claude/memory/sessions/xxx.md` 引用
+```
+
+---
+
+## 记忆文件格式
+
+保存的记忆文件应包含以下结构化信息：
+
+```markdown
+# 会话: <简短描述>
+
+**日期**: YYYY-MM-DD HH:MM
+**项目**: <项目名称>
+**路径**: .claude/memory/sessions/YYYY-MM-DD-<name>.md
+**会话ID**: <短ID>
+
+## 已完成
+- [具体完成的任务]
+
+## 进行中
+- [正在进行的任务] - 当前状态: [描述]
+
+## 关键决策
+- [决策] - 原因: [为什么这样决定]
+
+## 遇到的问题
+- [问题] - 解决方案: [如何解决的]
+
+## 下次继续
+- [ ] 待办事项1
+- [ ] 待办事项2
+
+## 需要加载的文件
+- `path/to/file` - [为什么需要]
+
+## 相关上下文
+[任何额外的重要背景信息]
+```
+
+---
+
+## 相关命令
+
+| 命令 | 说明 |
+|------|------|
+| `/save-session [name]` | 保存当前会话状态 |
+| `/load-session [name]` | 加载指定会话记忆 |
+| `/list-sessions` | 列出所有可用的会话记忆 |
+
+---
+
+## 最佳实践
+
+### 保存时机
+
+- **宁可多保存**：不确定是否需要保存时，建议保存
+- **有意义的命名**：使用描述性名称，如 `feature-auth`、`bug-fix-login`
+- **及时保存**：完成阶段性工作后立即保存
+
+### 加载时机
+
+- **按需加载**：不要主动读取所有记忆，让用户选择
+- **展示摘要**：加载后先展示摘要，确认是否需要深入
+- **提示相关文件**：如果记忆中有"需要加载的文件"，询问是否读取
+
+### 与用户协作
+
+- **不要过度打扰**：不是每次对话都需要提醒保存
+- **尊重用户选择**：用户拒绝保存时不要反复提醒
+- **主动但不强制**：建议是建议，最终由用户决定

package/bundles/tdd-bundle/README.md

@@ -0,0 +1,33 @@
+# TDD Bundle
+
+测试驱动开发（TDD）完整工作流配置包。
+
+## 包含内容
+
+- **Command**: `/tdd` - TDD 工作流命令，执行 RED-GREEN-REFACTOR 循环
+- **Skill**: `tdd-workflow` - TDD 最佳实践和测试模式
+- **Agent**: `tdd-guide` - TDD 指导专家子代理
+
+## 使用方式
+
+```bash
+# 安装 TDD bundle
+npx agent-configs install tdd-bundle
+
+# 或单独安装
+npx agent-configs install tdd
+npx agent-configs install tdd-workflow
+npx agent-configs install tdd-guide
+```
+
+## TDD 工作流
+
+1. **RED** - 写一个失败的测试
+2. **GREEN** - 写最少的代码让测试通过
+3. **REFACTOR** - 重构代码，保持测试通过
+
+## 相关命令
+
+- `/tdd` - 启动 TDD 工作流
+- `/test-coverage` - 检查测试覆盖率
+- `/e2e` - 运行 E2E 测试

package/bundles/tdd-bundle/manifest.json

@@ -0,0 +1,10 @@
+{
+  "name": "tdd-bundle",
+  "description": "TDD 完整工作流 - 测试驱动开发的命令、技能和代理",
+  "version": "1.0.0",
+  "includes": [
+    { "type": "command", "name": "tdd", "path": "commands/tdd.md" },
+    { "type": "skill", "name": "tdd-workflow", "path": "skills/tdd-workflow/" },
+    { "type": "agent", "name": "tdd-guide", "path": "agents/tdd-guide.md" }
+  ]
+}