agent-configs 1.0.0 → 1.0.1

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/docs-bundle/.claude/commands/update-codemaps.md

@@ -0,0 +1,17 @@
+# Update Codemaps
+
+Analyze the codebase structure and update architecture documentation:
+
+1. Scan all source files for imports, exports, and dependencies
+2. Generate token-lean codemaps in the following format:
+   - codemaps/architecture.md - Overall architecture
+   - codemaps/backend.md - Backend structure
+   - codemaps/frontend.md - Frontend structure
+   - codemaps/data.md - Data models and schemas
+
+3. Calculate diff percentage from previous version
+4. If changes > 30%, request user approval before updating
+5. Add freshness timestamp to each codemap
+6. Save reports to .reports/codemap-diff.txt
+
+Use TypeScript/Node.js for analysis. Focus on high-level structure, not implementation details.

package/bundles/docs-bundle/.claude/commands/update-docs.md

@@ -0,0 +1,31 @@
+# Update Documentation
+
+Sync documentation from source-of-truth:
+
+1. Read package.json scripts section
+   - Generate scripts reference table
+   - Include descriptions from comments
+
+2. Read .env.example
+   - Extract all environment variables
+   - Document purpose and format
+
+3. Generate docs/CONTRIB.md with:
+   - Development workflow
+   - Available scripts
+   - Environment setup
+   - Testing procedures
+
+4. Generate docs/RUNBOOK.md with:
+   - Deployment procedures
+   - Monitoring and alerts
+   - Common issues and fixes
+   - Rollback procedures
+
+5. Identify obsolete documentation:
+   - Find docs not modified in 90+ days
+   - List for manual review
+
+6. Show diff summary
+
+Single source of truth: package.json and .env.example

package/bundles/docs-bundle/.claude/settings.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md|AGENTS\\\\.md|CONTRIBUTING\\\\.md|CHANGELOG\\\\.md\")",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path||'';if(/\\.(md|txt)$/.test(p)&&!/(README|CLAUDE|AGENTS|CONTRIBUTING|CHANGELOG)\\.md$/.test(p)&&!/codemaps\\//.test(p)&&!/docs\\//.test(p)){console.error('[Hook] BLOCKED: Unnecessary documentation file creation');console.error('[Hook] File: '+p);console.error('[Hook] Use README.md or docs/ directory instead');process.exit(1)}console.log(d)})\""
+          }
+        ],
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');try{const diff=execSync('git diff --name-only HEAD 2>/dev/null',{encoding:'utf8'});const staged=execSync('git diff --name-only --cached 2>/dev/null',{encoding:'utf8'});const all=[...diff.split('\\n'),...staged.split('\\n')].filter(Boolean);const code=all.filter(f=>/\\.(js|ts|tsx|jsx|json)$/.test(f)&&!/package-lock|pnpm-lock/.test(f));const docs=all.filter(f=>/README\\.md|CLAUDE\\.md|CHANGELOG/.test(f));if(code.length>0&&docs.length===0){console.log(JSON.stringify({reminder:'📝 Code changed but docs not updated. Modified: '+code.slice(0,3).join(', ')+(code.length>3?' (+'+(code.length-3)+' more)':'')+'. Consider: /update-docs'}));}}catch(e){}\""
+          }
+        ],
+        "description": "Remind to update docs when code changes but README unchanged"
+      }
+    ]
+  }
+}

package/bundles/docs-bundle/.cursor/commands/update-codemaps.md

@@ -0,0 +1,17 @@
+# Update Codemaps
+
+Analyze the codebase structure and update architecture documentation:
+
+1. Scan all source files for imports, exports, and dependencies
+2. Generate token-lean codemaps in the following format:
+   - codemaps/architecture.md - Overall architecture
+   - codemaps/backend.md - Backend structure
+   - codemaps/frontend.md - Frontend structure
+   - codemaps/data.md - Data models and schemas
+
+3. Calculate diff percentage from previous version
+4. If changes > 30%, request user approval before updating
+5. Add freshness timestamp to each codemap
+6. Save reports to .reports/codemap-diff.txt
+
+Use TypeScript/Node.js for analysis. Focus on high-level structure, not implementation details.

package/bundles/docs-bundle/.cursor/commands/update-docs.md

@@ -0,0 +1,31 @@
+# Update Documentation
+
+Sync documentation from source-of-truth:
+
+1. Read package.json scripts section
+   - Generate scripts reference table
+   - Include descriptions from comments
+
+2. Read .env.example
+   - Extract all environment variables
+   - Document purpose and format
+
+3. Generate docs/CONTRIB.md with:
+   - Development workflow
+   - Available scripts
+   - Environment setup
+   - Testing procedures
+
+4. Generate docs/RUNBOOK.md with:
+   - Deployment procedures
+   - Monitoring and alerts
+   - Common issues and fixes
+   - Rollback procedures
+
+5. Identify obsolete documentation:
+   - Find docs not modified in 90+ days
+   - List for manual review
+
+6. Show diff summary
+
+Single source of truth: package.json and .env.example

package/bundles/docs-bundle/.cursor/hooks.json

@@ -0,0 +1,19 @@
+{
+  "version": 1,
+  "hooks": {
+    "preToolUse": [
+      {
+        "matcher": "Write",
+        "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path||'';if(/\\.(md|txt)$/.test(p)&&!/(README|CLAUDE|AGENTS|CONTRIBUTING|CHANGELOG)\\.md$/.test(p)&&!/codemaps\\//.test(p)&&!/docs\\//.test(p)){console.error('[Hook] BLOCKED: Unnecessary documentation file creation');console.error('[Hook] File: '+p);console.error('[Hook] Use README.md or docs/ directory instead');process.exit(2)}})\"",
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      }
+    ],
+    "stop": [
+      {
+        "command": "node -e \"const{execSync}=require('child_process');try{const diff=execSync('git diff --name-only HEAD 2>/dev/null',{encoding:'utf8'});const staged=execSync('git diff --name-only --cached 2>/dev/null',{encoding:'utf8'});const all=[...diff.split('\\n'),...staged.split('\\n')].filter(Boolean);const code=all.filter(f=>/\\.(js|ts|tsx|jsx|json)$/.test(f)&&!/package-lock|pnpm-lock/.test(f));const docs=all.filter(f=>/README\\.md|CLAUDE\\.md|CHANGELOG/.test(f));if(code.length>0&&docs.length===0){const files=code.slice(0,3).join(', ')+(code.length>3?' (+'+(code.length-3)+' more)':'');console.log(JSON.stringify({followup_message:'[文档提醒] 代码已修改但文档未更新。修改的文件: '+files+'。如需更新文档请使用 /update-docs，否则请忽略此消息。'}));}else{console.log('{}');}}catch(e){console.log('{}');}\"",
+        "loop_limit": 1,
+        "description": "Remind to update docs when code changes but README unchanged"
+      }
+    ]
+  }
+}

package/bundles/review-bundle/.claude/agents/code-reviewer.md

@@ -0,0 +1,104 @@
+---
+name: code-reviewer
+description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. MUST BE USED for all code changes.
+tools: ["Read", "Grep", "Glob", "Bash"]
+model: opus
+---
+
+You are a senior code reviewer ensuring high standards of code quality and security.
+
+When invoked:
+1. Run git diff to see recent changes
+2. Focus on modified files
+3. Begin review immediately
+
+Review checklist:
+- Code is simple and readable
+- Functions and variables are well-named
+- No duplicated code
+- Proper error handling
+- No exposed secrets or API keys
+- Input validation implemented
+- Good test coverage
+- Performance considerations addressed
+- Time complexity of algorithms analyzed
+- Licenses of integrated libraries checked
+
+Provide feedback organized by priority:
+- Critical issues (must fix)
+- Warnings (should fix)
+- Suggestions (consider improving)
+
+Include specific examples of how to fix issues.
+
+## Security Checks (CRITICAL)
+
+- Hardcoded credentials (API keys, passwords, tokens)
+- SQL injection risks (string concatenation in queries)
+- XSS vulnerabilities (unescaped user input)
+- Missing input validation
+- Insecure dependencies (outdated, vulnerable)
+- Path traversal risks (user-controlled file paths)
+- CSRF vulnerabilities
+- Authentication bypasses
+
+## Code Quality (HIGH)
+
+- Large functions (>50 lines)
+- Large files (>800 lines)
+- Deep nesting (>4 levels)
+- Missing error handling (try/catch)
+- console.log statements
+- Mutation patterns
+- Missing tests for new code
+
+## Performance (MEDIUM)
+
+- Inefficient algorithms (O(n²) when O(n log n) possible)
+- Unnecessary re-renders in React
+- Missing memoization
+- Large bundle sizes
+- Unoptimized images
+- Missing caching
+- N+1 queries
+
+## Best Practices (MEDIUM)
+
+- Emoji usage in code/comments
+- TODO/FIXME without tickets
+- Missing JSDoc for public APIs
+- Accessibility issues (missing ARIA labels, poor contrast)
+- Poor variable naming (x, tmp, data)
+- Magic numbers without explanation
+- Inconsistent formatting
+
+## Review Output Format
+
+For each issue:
+```
+[CRITICAL] Hardcoded API key
+File: src/api/client.ts:42
+Issue: API key exposed in source code
+Fix: Move to environment variable
+
+const apiKey = "sk-abc123";  // ❌ Bad
+const apiKey = process.env.API_KEY;  // ✓ Good
+```
+
+## Approval Criteria
+
+- ✅ Approve: No CRITICAL or HIGH issues
+- ⚠️ Warning: MEDIUM issues only (can merge with caution)
+- ❌ Block: CRITICAL or HIGH issues found
+
+## Project-Specific Guidelines (Example)
+
+Add your project-specific checks here. Examples:
+- Follow MANY SMALL FILES principle (200-400 lines typical)
+- No emojis in codebase
+- Use immutability patterns (spread operator)
+- Verify database RLS policies
+- Check AI integration error handling
+- Validate cache fallback behavior
+
+Customize based on your project's `CLAUDE.md` or skill files.