agent-configs 1.0.0

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

@@ -0,0 +1,77 @@
+---
+name: continuous-learning
+description: 持续学习能力 - 从会话中自动提取可复用的 patterns，保存为 skills 或 instincts。
+version: 2.0.0
+---
+
+# Continuous Learning - 持续学习
+
+## 这是什么
+
+这是一个让 AI 具备"学习意识"的能力。通过观察会话中的 patterns，将有价值的知识提取并保存，供未来会话使用。
+
+核心理念：**如果你不得不多次重复相同的提示，或者 AI 遇到了同样的问题——这些 patterns 应该被保存下来。**
+
+## 何时建议学习
+
+在以下情况，**主动建议**用户运行 `/learn`：
+
+### 触发场景
+
+1. **解决了复杂的 bug**
+   - 调试过程超过 3 步
+   - 发现了非显而易见的根因
+   - 解决方案可能对其他项目有用
+
+2. **做出了重要的变通**
+   - 绕过了库/API 的限制
+   - 找到了版本兼容问题的解决方案
+
+3. **用户进行了纠正**
+   - 用户纠正了你的方法
+   - 用户指出了更好的做法
+
+4. **重复的工作流**
+   - 同样的步骤序列执行了多次
+   - 可以抽象为可复用的流程
+
+### 提醒方式
+
+```
+💡 这个解决方案看起来可能对其他项目有用。
+   想要保存为 skill 吗？运行 /learn
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/learn` | 手动提取当前会话的 patterns |
+| `/instinct-status` | 显示所有已学习的 instincts 及置信度 |
+| `/evolve` | 将相关 instincts 聚合为 skills/commands/agents |
+
+## 文件位置
+
+```
+~/.claude/
+├── skills/
+│   └── learned/                # 直接学习的 skills
+│       └── *.md
+│
+└── homunculus/                 # instinct-based 学习
+    ├── observations.jsonl      # 观察记录
+    ├── instincts/
+    │   ├── personal/           # 自动学习的 instincts
+    │   └── inherited/          # 从他人导入的
+    └── evolved/
+        ├── skills/
+        ├── commands/
+        └── agents/
+```
+
+## 最佳实践
+
+- **不要过度打扰**：不是每次对话都需要提醒保存
+- **尊重用户选择**：用户拒绝时不要反复提醒
+- **主动但不强制**：建议是建议，最终由用户决定
+- **聚焦有价值的 patterns**：只保存能在未来节省时间的内容

package/bundles/continuous-learning/README.md

@@ -0,0 +1,159 @@
+# Continuous Learning Bundle
+
+从会话中自动提取可复用的 patterns，让 AI 具备"学习意识"。
+
+## 核心理念
+
+> 如果你不得不多次重复相同的提示，或者 AI 遇到了同样的问题——这些 patterns 应该被保存下来。
+
+## 功能特点
+
+### v1: Learned Skills（简单版）
+
+使用 Stop hook 在会话结束时评估，直接提取为完整 skills。
+
+- **优点**: 简单直接，立即可用
+- **存储位置**: `~/.claude/skills/learned/`
+- **适合**: 希望快速开始的用户
+
+### v2: Instincts + Evolution（高级版）
+
+使用 PreToolUse/PostToolUse hooks 实时观察，创建原子级 "instincts"（带置信度），支持进化。
+
+- **优点**: 更精细的学习，支持置信度衰减和进化
+- **存储位置**: `~/.claude/homunculus/`
+- **适合**: 希望深度定制的高级用户
+
+## 安装
+
+### 对于 Claude Code
+
+```bash
+# 复制整个 .claude 目录到你的项目或用户目录
+cp -r .claude/* ~/.claude/
+
+# 或者只复制到项目
+cp -r .claude/* /path/to/project/.claude/
+```
+
+### 对于 Cursor
+
+```bash
+# 复制 .cursor 目录到你的项目
+cp -r .cursor/* /path/to/project/.cursor/
+```
+
+## Hook 配置
+
+### 基础配置（v1 - 仅 Stop hook）
+
+在 `settings.json` 中添加：
+
+```json
+{
+  "hooks": {
+    "Stop": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ~/.claude/hooks/learning-end.js"
+      }]
+    }]
+  }
+}
+```
+
+### 高级配置（v2 - 包含观察 hooks）
+
+```json
+{
+  "hooks": {
+    "Stop": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ~/.claude/hooks/learning-end.js"
+      }]
+    }],
+    "PreToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ~/.claude/hooks/observe.js pre"
+      }]
+    }],
+    "PostToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ~/.claude/hooks/observe.js post"
+      }]
+    }]
+  }
+}
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/learn` | 手动提取当前会话的 patterns |
+| `/instinct-status` | 显示所有已学习的 instincts 及置信度 |
+| `/evolve` | 将相关 instincts 聚合为 skills/commands/agents |
+
+## 目录结构
+
+```
+~/.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
+```
+
+## Pattern 类型
+
+| Pattern | 说明 |
+|---------|------|
+| `error_resolution` | 特定错误如何被解决 |
+| `user_corrections` | 用户纠正的行为 |
+| `workarounds` | 框架/库的变通方案 |
+| `debugging_techniques` | 有效的调试方法 |
+| `project_specific` | 项目特定的约定 |
+
+## Instinct 置信度（v2）
+
+| 分数 | 含义 | 行为 |
+|------|------|------|
+| 0.3 | 尝试性 | 建议但不强制 |
+| 0.5 | 中等 | 在相关时应用 |
+| 0.7 | 强 | 自动批准应用 |
+| 0.9 | 近乎确定 | 核心行为 |
+
+## 为什么使用 Stop Hook？
+
+> "v1 依赖 skills 进行观察。Skills 是概率性的——触发率约 50-80%。v2 使用 hooks 进行观察（100% 可靠），instincts 作为学习的原子单位。"
+
+- **UserPromptSubmit**: 每条消息都运行 → 增加延迟
+- **Stop**: 只在会话结束运行一次 → 轻量级
+
+## 相关资源
+
+- [The Longform Guide](https://github.com/affaan-m/everything-claude-code) - Continuous learning 章节
+- [Homunculus](https://github.com/humanplane/homunculus) - v2 架构的灵感来源
+
+## 许可
+
+MIT

package/bundles/continuous-learning/manifest.json

@@ -0,0 +1,51 @@
+{
+  "name": "continuous-learning-bundle",
+  "description": "持续学习能力 - 从会话中自动提取可复用的 patterns，保存为 skills 或 instincts，支持进化为更高级结构",
+  "version": "2.0.0",
+  "includes": {
+    "claude": {
+      "commands": [
+        { "name": "learn", "path": ".claude/commands/learn.md" },
+        { "name": "instinct-status", "path": ".claude/commands/instinct-status.md" },
+        { "name": "evolve", "path": ".claude/commands/evolve.md" }
+      ],
+      "hooks": [
+        { "name": "learning-end", "type": "Stop", "path": ".claude/hooks/learning-end.js" },
+        { "name": "observe", "type": "PreToolUse|PostToolUse", "path": ".claude/hooks/observe.js" }
+      ],
+      "skills": [
+        { "name": "continuous-learning", "path": ".claude/skills/continuous-learning/" }
+      ],
+      "lib": [
+        { "name": "utils", "path": ".claude/lib/utils.js" },
+        { "name": "learning", "path": ".claude/lib/learning.js" }
+      ]
+    },
+    "cursor": {
+      "rules": [
+        { "name": "continuous-learning", "path": ".cursor/rules/continuous-learning.mdc" }
+      ],
+      "hooks": [
+        { "name": "learning-end", "path": ".cursor/hooks/learning-end.js" }
+      ],
+      "skills": [
+        { "name": "continuous-learning", "path": ".cursor/skills/continuous-learning/" }
+      ]
+    }
+  },
+  "features": {
+    "v1": {
+      "name": "Learned Skills",
+      "description": "简单版 - Stop hook 会话结束评估，直接保存为 skills",
+      "storage": "~/.claude/skills/learned/"
+    },
+    "v2": {
+      "name": "Instincts + Evolution",
+      "description": "高级版 - PreToolUse/PostToolUse hooks 实时观察，原子级 instincts，支持进化",
+      "storage": "~/.claude/homunculus/"
+    }
+  },
+  "dependencies": [],
+  "conflicts": [],
+  "recommended_with": ["shared-memory"]
+}

package/bundles/planning-bundle/README.md

@@ -0,0 +1,34 @@
+# Planning Bundle
+
+规划和架构设计配置包，提供功能规划和系统架构设计的完整支持。
+
+## 包含内容
+
+- **Command**: `/plan` - 规划命令，创建实现方案并等待确认
+- **Agent**: `planner` - 功能规划专家子代理
+- **Agent**: `architect` - 系统架构专家子代理
+
+## 使用方式
+
+```bash
+# 安装 Planning bundle
+npx agent-configs install planning-bundle
+
+# 或单独安装
+npx agent-configs install plan
+npx agent-configs install planner
+npx agent-configs install architect
+```
+
+## 规划流程
+
+1. **需求分析** - 理解需求，列出假设和约束
+2. **架构审查** - 分析现有代码结构，识别影响范围
+3. **步骤分解** - 创建详细的实现步骤
+4. **风险评估** - 识别潜在问题和缓解措施
+5. **等待确认** - 必须等待用户确认后才开始编码
+
+## 相关命令
+
+- `/plan` - 创建实现计划
+- `/code-review` - 审查实现代码

package/bundles/planning-bundle/manifest.json

@@ -0,0 +1,10 @@
+{
+  "name": "planning-bundle",
+  "description": "规划和架构设计 - 功能规划和系统架构的完整配置",
+  "version": "1.0.0",
+  "includes": [
+    { "type": "command", "name": "plan", "path": "commands/plan.md" },
+    { "type": "agent", "name": "planner", "path": "agents/planner.md" },
+    { "type": "agent", "name": "architect", "path": "agents/architect.md" }
+  ]
+}

package/bundles/review-bundle/README.md

@@ -0,0 +1,43 @@
+# Review Bundle
+
+代码审查全套配置包，提供代码质量和安全审查的完整支持。
+
+## 包含内容
+
+- **Command**: `/code-review` - 代码审查命令，检查质量和安全问题
+- **Skill**: `security-review` - 安全审查检查清单和最佳实践
+- **Agent**: `code-reviewer` - 代码审查专家子代理
+- **Agent**: `security-reviewer` - 安全审查专家子代理
+
+## 使用方式
+
+```bash
+# 安装 Review bundle
+npx agent-configs install review-bundle
+
+# 或单独安装
+npx agent-configs install code-review
+npx agent-configs install security-review
+npx agent-configs install code-reviewer
+npx agent-configs install security-reviewer
+```
+
+## 审查检查项
+
+### 安全检查（CRITICAL）
+- 硬编码凭证、API 密钥
+- SQL 注入漏洞
+- XSS 漏洞
+- 缺少输入验证
+
+### 代码质量（HIGH）
+- 函数过长（>50 行）
+- 文件过大（>800 行）
+- 嵌套过深（>4 层）
+- 缺少错误处理
+- console.log 语句
+
+## 相关命令
+
+- `/code-review` - 执行代码审查
+- `/plan` - 规划实现方案

package/bundles/review-bundle/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "review-bundle",
+  "description": "代码审查全套 - 代码质量和安全审查的完整配置",
+  "version": "1.0.0",
+  "includes": [
+    { "type": "command", "name": "code-review", "path": "commands/code-review.md" },
+    { "type": "skill", "name": "security-review", "path": "skills/security-review/" },
+    { "type": "agent", "name": "code-reviewer", "path": "agents/code-reviewer.md" },
+    { "type": "agent", "name": "security-reviewer", "path": "agents/security-reviewer.md" }
+  ]
+}

package/bundles/shared-memory/.claude/commands/list-sessions.md

@@ -0,0 +1,124 @@
+---
+name: list-sessions
+description: 列出所有可用的会话记忆，支持按时间筛选。
+argument-hint: "[--all|--days <n>]"
+---
+
+# List Sessions Command
+
+列出当前项目中所有可用的会话记忆。
+
+## 用法
+
+```
+/list-sessions [options]
+```
+
+### 参数选项
+
+- **无参数**：显示最近 10 条记忆
+- `--all`：显示所有记忆（不限数量）
+- `--days <n>`：只显示最近 n 天的记忆
+
+## 执行步骤
+
+### 1. 扫描记忆目录
+
+读取 `.claude/memory/sessions/` 目录下的所有 `.md` 文件。
+
+### 2. 解析元数据
+
+对每个文件，提取：
+- 日期（从文件名）
+- 名称（从文件名）
+- 状态（从内容解析：进行中/已完成）
+- 相对路径
+
+### 3. 按时间排序
+
+按修改时间倒序排列（最新的在前）。
+
+### 4. 生成列表
+
+输出格式化的表格。
+
+## 输出格式
+
+```
+## 可用会话记忆
+
+| # | 日期 | 名称 | 状态 | 路径 |
+|---|------|------|------|------|
+| 1 | 2026-01-27 | feature-auth | 进行中 | .claude/memory/sessions/2026-01-27-feature-auth.md |
+| 2 | 2026-01-26 | bug-fix-login | 已完成 | .claude/memory/sessions/2026-01-26-bug-fix-login.md |
+| 3 | 2026-01-25 | refactor-api | 已完成 | .claude/memory/sessions/2026-01-25-refactor-api.md |
+| 4 | 2026-01-24 | setup-project | 已完成 | .claude/memory/sessions/2026-01-24-setup-project.md |
+
+💡 使用方式：
+- `/load-session <#>` 或 `/load-session <名称>` 加载
+- 直接 `@.claude/memory/sessions/<文件名>` 引用
+```
+
+## 示例
+
+### 示例 1：默认列表
+
+```
+用户: /list-sessions
+
+AI: ## 可用会话记忆
+
+| # | 日期 | 名称 | 状态 | 路径 |
+|---|------|------|------|------|
+| 1 | 2026-01-27 | feature-auth | 进行中 | .claude/memory/sessions/2026-01-27-feature-auth.md |
+| 2 | 2026-01-26 | bug-fix-login | 已完成 | .claude/memory/sessions/2026-01-26-bug-fix-login.md |
+
+💡 使用方式：
+- `/load-session 1` 或 `/load-session feature-auth` 加载
+- 直接 `@.claude/memory/sessions/2026-01-27-feature-auth.md` 引用
+```
+
+### 示例 2：筛选最近 3 天
+
+```
+用户: /list-sessions --days 3
+
+AI: ## 最近 3 天的会话记忆
+
+| # | 日期 | 名称 | 状态 | 路径 |
+|---|------|------|------|------|
+| 1 | 2026-01-27 | feature-auth | 进行中 | .claude/memory/sessions/2026-01-27-feature-auth.md |
+| 2 | 2026-01-26 | bug-fix-login | 已完成 | .claude/memory/sessions/2026-01-26-bug-fix-login.md |
+| 3 | 2026-01-25 | refactor-api | 已完成 | .claude/memory/sessions/2026-01-25-refactor-api.md |
+
+💡 使用方式：
+- `/load-session <#>` 或 `/load-session <名称>` 加载
+- 直接 `@.claude/memory/sessions/<文件名>` 引用
+```
+
+### 示例 3：无记忆
+
+```
+用户: /list-sessions
+
+AI: 暂无会话记忆。
+
+使用 `/save-session <名称>` 保存当前会话，便于下次继续。
+```
+
+## 状态判断逻辑
+
+- **进行中**：文件中包含未完成的待办项（`- [ ]`）或"进行中"部分有内容
+- **已完成**：没有未完成的待办项
+
+## 注意事项
+
+1. **只显示当前项目的记忆**：不会显示其他项目的记忆文件
+2. **路径可直接引用**：表格中的路径可以直接用 `@` 引用
+3. **默认限制数量**：避免列表过长，默认最多显示 10 条
+4. **按时间排序**：最新的记忆排在最前面
+
+## 相关命令
+
+- `/save-session` - 保存当前会话
+- `/load-session` - 加载指定会话记忆

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

@@ -0,0 +1,169 @@
+---
+name: load-session
+description: 加载之前保存的会话记忆，恢复工作上下文。
+argument-hint: "[name|number|path]"
+---
+
+# Load Session Command
+
+加载之前保存的会话状态，恢复工作上下文。
+
+## 用法
+
+```
+/load-session [name|number|path]
+```
+
+- **无参数**：显示最近 5 个可用记忆，让用户选择
+- **数字参数**：加载列表中对应序号的记忆（如 `/load-session 1`）
+- **名称参数**：模糊匹配文件名（如 `/load-session feature-auth`）
+- **路径参数**：直接加载指定文件（如 `/load-session .claude/memory/sessions/2026-01-27-feature-auth.md`）
+
+## 执行步骤
+
+### 场景 1：无参数调用
+
+当用户只输入 `/load-session` 时：
+
+1. 扫描 `.claude/memory/sessions/` 目录
+2. 列出最近 5 个记忆文件
+3. 显示选择列表
+
+```
+## 最近的会话记忆
+
+| # | 日期 | 名称 | 状态 |
+|---|------|------|------|
+| 1 | 2026-01-27 | feature-auth | 进行中 |
+| 2 | 2026-01-26 | bug-fix-login | 已完成 |
+| 3 | 2026-01-25 | refactor-api | 已完成 |
+
+请选择要加载的记忆：
+- 输入序号（如 `1`）
+- 输入名称（如 `feature-auth`）
+- 或使用 `/list-sessions` 查看更多
+```
+
+### 场景 2：有参数调用
+
+当用户指定了参数时：
+
+1. **解析参数**
+   - 数字 → 作为列表序号
+   - 名称 → 模糊匹配文件名
+   - 路径 → 直接读取文件
+
+2. **读取记忆文件**
+   - 读取匹配的 `.md` 文件内容
+   - 解析元数据（标题、状态、待办等）
+
+3. **展示内容摘要**
+
+```
+## 加载会话: feature-auth
+
+**日期**: 2026-01-27 14:30
+**状态**: 进行中
+
+### 上次完成
+- 实现了用户认证模块
+- 完成 JWT token 生成逻辑
+- 解决了 token 刷新问题
+
+### 待继续
+- [ ] 实现权限校验中间件
+- [ ] 添加单元测试
+
+### 需要的文件
+- `src/auth/jwt.ts`
+- `src/middleware/auth.ts`
+
+---
+
+是否需要我读取这些相关文件？
+```
+
+4. **询问后续操作**
+   - 是否读取"需要加载的文件"
+   - 是否继续待办事项中的第一个任务
+
+## 示例
+
+### 示例 1：加载最近的记忆
+
+```
+用户: /load-session 1
+
+AI: ## 加载会话: feature-auth
+
+**日期**: 2026-01-27 14:30
+**状态**: 进行中
+
+### 上次完成
+- 实现了用户认证模块的基础结构
+- 选择 JWT 方案并完成 token 生成
+- 解决了 token 过期后的刷新问题
+
+### 待继续
+- [ ] 实现权限校验中间件
+- [ ] 为认证模块添加单元测试
+
+### 关键决策
+- 使用 JWT 而非 Session：因为需要支持微服务架构
+- Token 过期时间设为 1 小时：平衡安全性和用户体验
+
+### 相关文件
+- `src/auth/jwt.ts` - JWT 核心逻辑
+- `src/middleware/auth.ts` - 认证中间件
+
+---
+
+需要我读取相关文件吗？或者直接开始第一个待办任务？
+```
+
+### 示例 2：按名称加载
+
+```
+用户: /load-session auth
+
+AI: 找到匹配的记忆: 2026-01-27-feature-auth.md
+
+[展示内容摘要...]
+```
+
+### 示例 3：未找到匹配
+
+```
+用户: /load-session xyz
+
+AI: 未找到匹配 "xyz" 的会话记忆。
+
+可用的记忆：
+| # | 日期 | 名称 |
+|---|------|------|
+| 1 | 2026-01-27 | feature-auth |
+| 2 | 2026-01-26 | bug-fix-login |
+
+请使用 `/load-session <序号>` 或 `/load-session <名称>` 加载。
+```
+
+## 加载后的行为
+
+加载记忆后，你应该：
+
+1. **记住上下文**：将记忆内容作为当前会话的背景知识
+2. **主动提供帮助**：如果有待办事项，询问是否开始
+3. **读取相关文件**：如果用户同意，读取"需要加载的文件"
+4. **延续之前的风格**：如果记忆中有技术决策，遵循之前的决定
+
+## 注意事项
+
+1. **不要重复读取**：如果用户已经用 `@` 引用了记忆文件，不需要再次读取
+2. **摘要优先**：先展示摘要，不要一次性输出全部内容
+3. **尊重用户选择**：询问是否需要读取文件，不要自动读取
+4. **处理旧记忆**：如果记忆很旧（超过 7 天），提醒用户内容可能已过时
+
+## 相关命令
+
+- `/save-session` - 保存当前会话
+- `/list-sessions` - 列出所有可用的会话记忆