agent-configs 1.0.0 → 1.0.3

package/README.md

@@ -8,7 +8,7 @@ CLI tool to install curated Claude Code and Cursor configurations.
 
 - **交互式菜单** - 上下选择、Enter 进入/安装、Esc 返回
 - **双平台支持** - Claude Code + Cursor（默认 Cursor）
-- **完整配置** - Commands + Skills + Rules + Agents + Hooks + Bundles
+- **完整配置** - Commands + Skills + Rules + Agents + Bundles（Hooks 通过 Bundles 提供）
 - **Bundle 优先** - 相关配置打包，一键安装
 
 ## 快速开始
@@ -41,11 +41,10 @@ agent-configs - Claude Code & Cursor 配置共享工具
 
 ? 选择类别
 ❯ Commands (10) ★2 (claude/cursor)
-  Skills (7) (claude/cursor)
+  Skills (8) (claude/cursor)
   Rules (8) ★1 (cursor)
   Agents (6) ★2 (claude/cursor)
-  Hooks (1) (claude/cursor)
-  Bundles (5) ★3
+  Bundles (6) ★4
   ──────────────
   退出
 ```
@@ -71,10 +70,11 @@ agent-configs - Claude Code & Cursor 配置共享工具
 | update-docs | 同步文档 |
 | update-codemaps | 更新架构文档 |
 
-### Skills（7 个）
+### Skills（8 个）
 
 | Skill | 说明 |
 |-------|------|
+| ai-config-architect | AI 配置架构师 - 生成 rules/skills/commands/hooks/agents 配置，支持 Claude/Cursor 双平台 |
 | tdd-workflow | TDD 完整工作流和最佳实践 |
 | security-review | 安全审查检查清单 |
 | coding-standards | 编码规范和风格指南 |
@@ -94,7 +94,7 @@ agent-configs - Claude Code & Cursor 配置共享工具
 | agents | 子代理使用规范 |
 | patterns | API 响应格式规范 |
 | performance | 模型选择和上下文管理 |
-| hooks | Hook 使用文档 |
+| hooks-guide | Hook 使用文档 |
 
 ### Agents（6 个）
 
@@ -107,15 +107,17 @@ agent-configs - Claude Code & Cursor 配置共享工具
 | security-reviewer | 安全审查专家 |
 | refactor-cleaner | 重构清理专家 |
 
-### Bundles（5 个）
+### Bundles（6 个）
 
 | Bundle | 包含内容 | 说明 |
 |--------|----------|------|
 | shared-memory | commands + hooks + lib + skills + rules | 跨会话记忆管理系统 |
 | tdd-bundle | tdd + tdd-workflow + tdd-guide | TDD 完整工作流 |
-| review-bundle | code-review + security-review + code-reviewer + security-reviewer | 代码审查全套 |
+| review-bundle | code-review + security-review + code-reviewer + security-reviewer + hooks | 代码审查全套 - 包含 /code-review 命令、审查 agents、Prettier/TypeScript/console.log 检查 hooks |
 | planning-bundle | plan + planner + architect | 规划和架构设计 |
 | bk-chat-bundle | bk-chat-helper + bk-chat-x | 蓝鲸 AI Chat 开发 |
+| continuous-learning | commands + hooks + lib + skills + rules | 持续学习 - 从会话中自动提取 patterns，保存为 skills/instincts |
+| docs-bundle | commands + hooks | 文档自动化 - 包含 /update-docs、/update-codemaps 命令及文档更新提醒 hooks |
 
 ## 使用方式
 
@@ -158,6 +160,8 @@ npx agent-configs install review-bundle
 npx agent-configs install planning-bundle
 npx agent-configs install bk-chat-bundle
 npx agent-configs install shared-memory
+npx agent-configs install continuous-learning
+npx agent-configs install docs-bundle
 
 # 指定平台
 npx agent-configs install plan --agent claude

package/bundles/continuous-learning/.cursor/commands/evolve.md

@@ -0,0 +1,190 @@
+# /evolve - 进化 Instincts 为 Skills/Commands/Agents
+
+分析已学习的 instincts，将相关的聚合为更高级的结构。
+
+## 触发
+
+运行 `/evolve` 分析并进化 instinct 集群。
+
+## 进化规则
+
+### → Command（用户主动调用）
+
+当 instincts 描述用户会显式请求的动作：
+
+- 多个 instincts 包含 "when user asks to..."
+- Instincts 的触发条件像 "when creating a new X"
+- Instincts 遵循可重复的序列
+
+**示例**:
+```
+instincts:
+  - new-table-step1: "when adding a database table, create migration"
+  - new-table-step2: "when adding a database table, update schema"
+  - new-table-step3: "when adding a database table, regenerate types"
+
+→ 生成: /new-table command
+```
+
+### → Skill（自动触发）
+
+当 instincts 描述应该自动发生的行为：
+
+- 模式匹配触发
+- 错误处理响应
+- 代码风格强制
+
+**示例**:
+```
+instincts:
+  - prefer-functional: "when writing functions, prefer functional style"
+  - use-immutable: "when modifying state, use immutable patterns"
+  - avoid-classes: "when designing modules, avoid class-based design"
+
+→ 生成: functional-patterns skill
+```
+
+### → Agent（需要深度/隔离）
+
+当 instincts 描述复杂的多步骤过程，受益于隔离执行：
+
+- 调试工作流
+- 重构序列
+- 研究任务
+
+**示例**:
+```
+instincts:
+  - debug-step1: "when debugging, first check logs"
+  - debug-step2: "when debugging, isolate the failing component"
+  - debug-step3: "when debugging, create minimal reproduction"
+  - debug-step4: "when debugging, verify fix with test"
+
+→ 生成: debugger agent
+```
+
+## 使用方式
+
+```bash
+/evolve                    # 分析所有 instincts 并建议进化
+/evolve --domain testing   # 只进化 testing domain 的 instincts
+/evolve --dry-run          # 预览将创建的内容，不实际创建
+/evolve --threshold 5      # 要求 5+ 相关 instincts 才形成集群
+/evolve --execute          # 实际创建进化后的结构
+```
+
+## 输出格式
+
+```
+🧬 Evolve Analysis
+==================
+
+Found 3 clusters ready for evolution:
+
+## Cluster 1: Database Migration Workflow
+Instincts: new-table-migration, update-schema, regenerate-types
+Type: Command
+Confidence: 85% (based on 12 observations)
+
+Would create: /new-table command
+Files:
+  - ~/.cursor/homunculus/evolved/commands/new-table.md
+
+## Cluster 2: Functional Code Style
+Instincts: prefer-functional, use-immutable, avoid-classes, pure-functions
+Type: Skill
+Confidence: 78% (based on 8 observations)
+
+Would create: functional-patterns skill
+Files:
+  - ~/.cursor/homunculus/evolved/skills/functional-patterns.md
+
+## Cluster 3: Debugging Process
+Instincts: debug-check-logs, debug-isolate, debug-reproduce, debug-verify
+Type: Agent
+Confidence: 72% (based on 6 observations)
+
+Would create: debugger agent
+Files:
+  - ~/.cursor/homunculus/evolved/agents/debugger.md
+
+---
+Run `/evolve --execute` to create these files.
+```
+
+## 处理流程
+
+1. 读取所有 instincts（`~/.cursor/homunculus/instincts/`）
+2. 按以下维度分组：
+   - Domain 相似性
+   - Trigger pattern 重叠
+   - Action 序列关系
+3. 对于每个 3+ 相关 instincts 的集群：
+   - 确定进化类型 (command/skill/agent)
+   - 生成对应文件
+   - 保存到 `~/.cursor/homunculus/evolved/{commands,skills,agents}/`
+4. 将进化后的结构链接回源 instincts
+
+## 生成文件格式
+
+### Command 格式
+```markdown
+---
+name: new-table
+description: Create a new database table with migration, schema update, and type generation
+command: /new-table
+evolved_from:
+  - new-table-migration
+  - update-schema
+  - regenerate-types
+---
+
+# New Table Command
+
+[基于聚合的 instincts 生成的内容]
+
+## Steps
+1. ...
+2. ...
+```
+
+### Skill 格式
+```markdown
+---
+name: functional-patterns
+description: Enforce functional programming patterns
+evolved_from:
+  - prefer-functional
+  - use-immutable
+  - avoid-classes
+---
+
+# Functional Patterns Skill
+
+[基于聚合的 instincts 生成的内容]
+```
+
+### Agent 格式
+```markdown
+---
+name: debugger
+description: Systematic debugging agent
+model: sonnet
+evolved_from:
+  - debug-check-logs
+  - debug-isolate
+  - debug-reproduce
+---
+
+# Debugger Agent
+
+[基于聚合的 instincts 生成的内容]
+```
+
+## 相关命令
+
+| 命令 | 说明 |
+|------|------|
+| `/instinct-status` | 查看所有 instincts |
+| `/learn` | 手动提取 patterns |
+| `/instinct-export` | 导出 instincts |

package/bundles/continuous-learning/.cursor/commands/instinct-status.md

@@ -0,0 +1,64 @@
+# /instinct-status - 查看已学习的 Instincts
+
+显示所有已学习的 instincts 及其置信度。
+
+## 触发
+
+运行 `/instinct-status` 查看当前学习状态。
+
+## 功能
+
+1. 列出所有 personal instincts（自动学习的）
+2. 列出所有 inherited instincts（从他人导入的）
+3. 显示每个 instinct 的置信度和 domain
+4. 标识可能可以进化的 instinct 集群
+
+## 输出格式
+
+```
+🧠 Instinct Status
+==================
+
+Personal Instincts (12):
+| ID | Domain | Confidence | Trigger |
+|----|--------|------------|---------|
+| prefer-functional | code-style | 0.75 | when writing new functions |
+| use-zod-validation | validation | 0.68 | when validating input |
+| ...
+
+Inherited Instincts (3):
+| ID | Source | Confidence |
+|----|--------|------------|
+| test-first | team-defaults | 0.90 |
+| ...
+
+Evolution Candidates:
+- code-style (4 instincts, avg 0.72) → could become skill
+- debugging (5 instincts, avg 0.65) → could become agent
+
+Use /evolve to turn instinct clusters into skills/commands/agents.
+```
+
+## 文件位置
+
+- Personal: `~/.cursor/homunculus/instincts/personal/`
+- Inherited: `~/.cursor/homunculus/instincts/inherited/`
+- Evolved: `~/.cursor/homunculus/evolved/{skills,commands,agents}/`
+
+## 实现
+
+读取并解析所有 instinct 文件，汇总状态信息。
+
+```bash
+# 底层实现（如果需要脚本执行）
+find ~/.cursor/homunculus/instincts -name "*.md" -exec cat {} \;
+```
+
+## 相关命令
+
+| 命令 | 说明 |
+|------|------|
+| `/learn` | 手动提取 patterns 为 skill |
+| `/evolve` | 将 instinct 集群进化为更高级结构 |
+| `/instinct-export` | 导出 instincts 分享给他人 |
+| `/instinct-import <file>` | 导入他人的 instincts |

package/bundles/continuous-learning/.cursor/commands/learn.md

@@ -0,0 +1,83 @@
+# /learn - 提取可复用的 Patterns
+
+分析当前会话，提取值得保存为 skills 的 patterns。
+
+## 触发
+
+在会话中任意时刻运行 `/learn`，当你解决了一个非平凡的问题时。
+
+## 要提取的内容
+
+寻找以下类型的 patterns：
+
+### 1. 错误解决模式
+- 遇到了什么错误？
+- 根本原因是什么？
+- 如何修复的？
+- 这个方案是否可复用于类似错误？
+
+### 2. 调试技巧
+- 非显而易见的调试步骤
+- 有效的工具组合
+- 诊断模式
+
+### 3. 变通方案
+- 库的特殊行为
+- API 限制
+- 版本特定的修复
+
+### 4. 项目特定模式
+- 发现的代码库约定
+- 做出的架构决策
+- 集成模式
+
+## 输出格式
+
+创建 skill 文件到 `~/.cursor/skills/learned/[pattern-name].md`：
+
+```markdown
+# [描述性的 Pattern 名称]
+
+**Extracted:** [日期]
+**Context:** [适用场景简述]
+
+## Problem
+[这个 pattern 解决什么问题 - 要具体]
+
+## Solution
+[pattern/技巧/变通方案]
+
+## Example
+[如果适用，代码示例]
+
+## When to Use
+[触发条件 - 什么情况应该激活这个 skill]
+```
+
+## 处理流程
+
+1. 回顾会话，寻找可提取的 patterns
+2. 识别最有价值/可复用的洞见
+3. 起草 skill 文件
+4. 询问用户确认后保存
+5. 保存到 `~/.cursor/skills/learned/`
+
+## 注意事项
+
+- **不要**提取简单问题（拼写错误、简单语法错误）
+- **不要**提取一次性问题（特定 API 故障等）
+- **聚焦**于能在未来会话中节省时间的 patterns
+- **保持聚焦** - 每个 skill 只包含一个 pattern
+
+## 与 Instincts 的区别
+
+| 特性 | Skill (v1) | Instinct (v2) |
+|------|------------|---------------|
+| 粒度 | 完整 pattern | 原子行为 |
+| 置信度 | 无 | 0.3-0.9 |
+| 进化 | 直接使用 | 可聚合为 skill/command/agent |
+| 创建方式 | 手动 `/learn` | 自动观察 |
+
+如果你想使用更高级的 instinct-based 学习系统，可以：
+- 使用 `/instinct-status` 查看已学习的 instincts
+- 使用 `/evolve` 将相关 instincts 进化为更高级结构

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

@@ -35,8 +35,8 @@ function expandPath(p) {
 
 // 默认配置
 const MIN_SESSION_LENGTH = 10;
-const LEARNED_SKILLS_PATH = expandPath('~/.claude/skills/learned/');
-const HOMUNCULUS_PATH = expandPath('~/.claude/homunculus/');
+const LEARNED_SKILLS_PATH = expandPath('~/.cursor/skills/learned/');
+const HOMUNCULUS_PATH = expandPath('~/.cursor/homunculus/');
 
 async function main() {
   try {

package/bundles/continuous-learning/.cursor/hooks.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "hooks": {
+    "stop": [
+      {
+        "command": "node .cursor/hooks/learning-end.js",
+        "loop_limit": 1,
+        "description": "Evaluate session for learnable patterns on session end"
+      }
+    ]
+  }
+}