[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Matt-Dionis--claude-code-configs":3,"tool-Matt-Dionis--claude-code-configs":64},[4,17,27,35,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",156033,2,"2026-04-14T23:32:00",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[25,14,26,13],"插件","图像",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":10,"last_commit_at":33,"category_tags":34,"status":16},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[25,13],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":41,"last_commit_at":42,"category_tags":43,"status":16},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,3,"2026-04-06T11:19:32",[15,26,14,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85092,"2026-04-10T11:13:16",[26,60,61,25,14,62,15,13,63],"数据工具","视频","其他","音频",{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":68,"owner_location":79,"owner_email":80,"owner_twitter":68,"owner_website":68,"owner_url":81,"languages":82,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":99,"env_os":100,"env_gpu":101,"env_ram":101,"env_deps":102,"category_tags":107,"github_topics":68,"view_count":10,"oss_zip_url":68,"oss_zip_packed_at":68,"status":16,"created_at":108,"updated_at":109,"faqs":110,"releases":111},7647,"Matt-Dionis\u002Fclaude-code-configs","claude-code-configs",null,"claude-code-configs 是一套专为热门开发框架和工具打造的生产级 Claude Code 配置集合。它旨在解决开发者在为新项目设置 AI 编程助手时，手动编写和整合复杂配置文件（如 CLAUDE.md）耗时且易出错的问题。通过提供开箱即用的标准化配置，它能帮助团队快速统一开发规范，提升协作效率。\n\n该工具特别适合前端工程师、全栈开发者以及技术团队使用，尤其是那些正在使用 Next.js、shadcn\u002Fui、Tailwind CSS、Drizzle ORM 或构建 MCP 服务器的用户。其核心亮点在于智能合并机制：用户只需一条命令，即可将多个不同领域的配置（如框架 +UI 库 + 数据库）自动融合，无需担心规则冲突。此外，它还具备零运行时依赖、完整的 TypeScript 类型支持以及自动备份和 Git 集成等特性，确保配置过程轻量、安全且符合版本管理习惯。无论是通过 npx 快速试用，还是全局安装频繁使用，claude-code-configs 都能让 AI 辅助编程环境的搭建变得简单而专业。","# 🚀 Claude Code Configs\n\n[![NPM Version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fclaude-config-composer)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fclaude-config-composer)\n[![NPM Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fclaude-config-composer)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fclaude-config-composer)\n[![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMatt-Dionis\u002Fclaude-code-configs)](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green)](LICENSE)\n[![Tests](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Node Version](https:\u002F\u002Fimg.shields.io\u002Fnode\u002Fv\u002Fclaude-config-composer)](https:\u002F\u002Fnodejs.org)\n\n> **Production-ready Claude Code configurations for popular frameworks and tools**\n\n🎉 **Version 1.0.0** - Production-ready with comprehensive testing and 124 passing tests\n📦 **NPM Package** - Install with `npm install -g claude-config-composer` or use `npx`\n\n## 🚨 **Breaking Changes for Existing Users**\n\n**This release fundamentally changes how configs are organized and used.**\n\n- ✅ **Migration Guide Available:** [MIGRATION.md](MIGRATION.md)\n- 🔄 Individual configs moved to `configurations\u002F` directory\n- 🎯 New CLI tool for intelligent config merging\n- ⚠️ Direct directory copying is deprecated\n\n## 🎯 Key Features\n\n- ✅ **124 Passing Tests** - Comprehensive test coverage\n- ✅ **8+ Production Configurations** - Frameworks, UI libraries, databases, MCP servers, and tools\n- ✅ **Intelligent Merging** - Combine multiple configs without conflicts\n- ✅ **Zero Dependencies** (runtime) - Lightweight and fast\n- ✅ **TypeScript** - Full type safety and modern development\n- ✅ **Git Integration** - Automatic .gitignore updates and backups\n\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b407973-4148-49e3-872f-ce3f9a3161f8\n\n\n### Report Issues\n\nFound a bug? Please report it at [GitHub Issues](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Fissues)\n\n## 🎯 Two Ways to Use This Repository\n\n### 1. 🚀 Generate Combined Configs (Recommended)\n\n**Quick Start with NPX (No Installation Required):**\n\n```bash\n# Generate configs directly in your project\nnpx claude-config-composer nextjs-15 shadcn\n\n# Or use interactive mode\nnpx claude-config-composer\n```\n\n**Global Installation:**\n\n```bash\n# Install globally for frequent use\nnpm install -g claude-config-composer\n\n# Then use from any project\nclaude-compose nextjs-15 shadcn tailwindcss\n```\n\n**Local Development (For Contributors):**\n\n```bash\n# Clone and set up the composer\ngit clone https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs.git\ncd claude-code-configs\u002Fclaude-config-composer\nnpm install && npm run build\n\n# Generate configs from your project directory\ncd \u002Fpath\u002Fto\u002Fyour\u002Fproject\nnode \u002Fpath\u002Fto\u002Fclaude-code-configs\u002Fclaude-config-composer\u002Fdist\u002Fcli.js nextjs-15 shadcn\n```\n\n**✨ Features:**\n\n- Intelligently merges multiple configs\n- Automatic backups of existing configs\n- Git-friendly (auto-adds to .gitignore)\n- Production-ready output\n- Zero installation (once published to npm)\n\n### 2. 📁 Manual Copy Individual Configs\n\n**For single framework setups:**\n\n```bash\n# Copy a specific configuration to your project\ncp -r configurations\u002Fframeworks\u002Fnextjs-15\u002F.claude your-project\u002F\ncp configurations\u002Fframeworks\u002Fnextjs-15\u002FCLAUDE.md your-project\u002F\n```\n\n**Available configurations:**\n\n**Frameworks:**\n\n- `nextjs-15` - Next.js 15 with App Router and React 19\n\n**UI & Styling:**\n\n- `shadcn` - shadcn\u002Fui component library with Radix UI\n- `tailwindcss` - Utility-first CSS framework with responsive design\n\n**Databases:**\n\n- `drizzle` - Type-safe ORM with schema management and migrations\n\n**Development Tools:**\n\n- `vercel-ai-sdk` - Streaming AI applications with function calling\n\n**MCP Servers (Complete Solutions):**\n\n- `memory-mcp-server` - MCP server with vector search and persistence\n- `token-gated-mcp-server` - Token-gated MCP server using the [Radius MCP SDK](https:\u002F\u002Fgithub.com\u002Fradiustechsystems\u002Fmcp-sdk)\n\n## 📸 What Gets Generated - Before & After Example\n\n### Before: Empty Project Directory\n\n```\nyour-nextjs-project\u002F\n├── app\u002F\n├── components\u002F\n├── package.json\n└── next.config.js\n```\n\n### After: Running `npx claude-config-composer nextjs-15 shadcn tailwindcss`\n\n```\nyour-nextjs-project\u002F\n├── app\u002F\n├── components\u002F\n├── package.json\n├── next.config.js\n├── CLAUDE.md                   # ✨ Combined best practices from all configs\n└── .claude\u002F                    # ✨ Generated configuration\n    ├── agents\u002F\n    │   ├── nextjs-app-router.md         # Next.js routing expertise\n    │   ├── component-builder.md         # shadcn component patterns\n    │   ├── responsive-designer.md       # Tailwind responsive design\n    │   └── ... (20+ more specialized agents)\n    ├── commands\u002F\n    │   ├── create-page.md               # Generate Next.js pages\n    │   ├── add-component.md             # Add shadcn components\n    │   ├── optimize-styles.md           # Tailwind optimization\n    │   └── ... (15+ workflow commands)\n    ├── hooks\u002F\n    │   ├── format-code.sh               # Auto-format on save\n    │   ├── validate-components.sh       # Component validation\n    │   └── optimize-imports.sh          # Import optimization\n    └── settings.json                    # Merged permissions & env vars\n```\n\n### 🎯 Key Benefits of Generated Config\n\n- **40+ specialized agents** covering Next.js, shadcn, and Tailwind expertise\n- **Intelligent permission controls** tailored to your stack\n- **Automated workflows** via hooks for formatting, validation, and optimization\n- **Zero conflicts** - all configurations intelligently merged\n- **Production-ready** - works immediately with Claude Code\n\n## 📁 Repository Structure\n\n```text\nclaude-config-composer\u002F         # 🔧 Dynamic config generator CLI tool\n├── src\u002F\n│   ├── cli.ts                 # Interactive CLI interface\n│   ├── parser\u002F                # Config parsing logic\n│   ├── merger\u002F                # Intelligent merging\n│   └── generator\u002F             # .claude directory generation\n└── README.md                  # Tool documentation\n\nconfigurations\u002F                 # 📦 All Claude Code configurations\n├── frameworks\u002F                 # Framework-specific configurations\n│   └── nextjs-15\u002F             # Next.js 15 with App Router & React 19\n│       ├── .claude\u002F           # Complete config with agents, commands, hooks\n│       ├── CLAUDE.md          # Next.js 15 development patterns\n│       └── README.md          # Setup and usage guide\n├── ui\u002F                        # UI library and styling configurations\n│   ├── shadcn\u002F                # shadcn\u002Fui component library\n│   │   ├── .claude\u002F           # UI development agents and commands\n│   │   ├── CLAUDE.md          # Component patterns and best practices\n│   │   └── README.md          # Installation and setup guide\n│   └── tailwindcss\u002F           # Utility-first CSS framework\n│       ├── .claude\u002F           # Styling and design system agents\n│       ├── CLAUDE.md          # Tailwind patterns and optimization\n│       └── README.md          # Configuration and usage guide\n├── databases\u002F                  # Database and ORM configurations\n│   └── drizzle\u002F               # Type-safe ORM with migrations\n│       ├── .claude\u002F           # Database development agents\n│       ├── CLAUDE.md          # Schema management and query patterns\n│       └── README.md          # Setup and migration guide\n├── tooling\u002F                   # Development tools and SDKs\n│   └── vercel-ai-sdk\u002F         # AI application development\n│       ├── .claude\u002F           # AI development agents and workflows\n│       ├── CLAUDE.md          # Streaming and function calling patterns\n│       └── README.md          # SDK setup and usage guide\n└── mcp-servers\u002F               # Complete MCP server solutions\n    ├── memory-mcp-server\u002F     # Memory-enabled MCP server\n    │   ├── .claude\u002F           # Full-stack development agents\n    │   ├── CLAUDE.md          # Vector search and persistence patterns\n    │   └── README.md          # Complete setup guide\n    └── token-gated-mcp-server\u002F # Authentication-enabled MCP server\n        ├── .claude\u002F           # Security and auth agents\n        ├── CLAUDE.md          # Token management and security patterns\n        └── README.md          # Authentication setup guide\n\ndocs\u002F                          # 📚 Documentation and guides\n├── claude-code-github-actions.md\n├── claude-code-sdk.md\n├── get-started-with-claude-code-hooks.md\n└── [other documentation files]\n\n# 🚧 Coming Soon:\n# configurations\u002F\n# ├── frameworks\u002F\n# │   ├── react-19\u002F           # Standalone React 19 patterns\n# │   └── svelte-5\u002F           # SvelteKit 2.0 configuration\n# ├── databases\u002F\n# │   ├── prisma\u002F             # Alternative ORM configuration\n# │   └── supabase\u002F           # Backend-as-a-Service setup\n# ├── testing\u002F\n# │   ├── vitest\u002F             # Fast testing framework\n# │   └── playwright\u002F         # E2E testing configuration\n# └── tooling\u002F\n#     ├── zod\u002F                # Schema validation patterns\n#     └── trpc\u002F               # End-to-end type safety\n```\n\n## 🚀 Quick Start with Claude Config Composer\n\n### Install and Use\n\n```bash\n# Quick start with npx (no installation)\nnpx claude-config-composer nextjs-15 shadcn tailwindcss\n\n# Or install globally\nnpm install -g claude-config-composer\n\n# Then use the short alias\nclaude-compose nextjs-15 shadcn\n```\n\n### Common Commands\n\n```bash\n# Interactive mode - choose configs visually\nnpx claude-config-composer\n\n# List all available configurations\nnpx claude-config-composer list\n\n# Generate full-stack configuration\nnpx claude-config-composer nextjs-15 shadcn tailwindcss drizzle vercel-ai-sdk\n\n# AI development stack\nnpx claude-config-composer vercel-ai-sdk drizzle\n\n# Preview without creating files\nnpx claude-config-composer dry-run nextjs-15 shadcn\n\n# Validate existing configuration\nnpx claude-config-composer validate\n```\n\n### What Gets Generated\n\nA complete `.claude\u002F` directory in your project with:\n\n- Combined agents from all selected configs\n- Merged commands and hooks\n- Unified settings.json\n- Comprehensive CLAUDE.md documentation\n\n## 🎯 Available Configurations\n\n### Memory MCP Server Configuration\n\nA production-grade configuration for building MCP servers with memory persistence and vector search:\n\n- **15 Specialized Agents** for MCP, database, and memory systems\n- **7 Custom Commands** for development workflows\n- **2 Automation Hooks** for TypeScript and logging\n- **Optimized for:** PostgreSQL 17, pgvector, Drizzle ORM, MCP SDK\n\n[View Memory MCP Server Details →](.\u002Fconfigurations\u002Fmcp-servers\u002Fmemory-mcp-server\u002FREADME.md)\n\n## 🎯 Framework-Specific Configurations\n\n### Next.js 15 Configuration\n\nA complete Claude Code configuration tailored for Next.js 15 development, including:\n\n#### Specialized Next.js Agents (11 total)\n\n**Core Development:**\n\n- **`nextjs-app-router`** - App Router routing patterns and best practices\n- **`nextjs-server-components`** - Server\u002FClient component optimization\n- **`nextjs-server-actions`** - Forms, mutations, and progressive enhancement\n- **`nextjs-data-fetching`** - Caching strategies and streaming\n- **`nextjs-performance`** - Bundle analysis and Core Web Vitals\n\n**Infrastructure & Quality:**\n\n- **`nextjs-testing`** - Jest, Vitest, Playwright setup\n- **`nextjs-deployment`** - Docker, Vercel, AWS deployment\n- **`nextjs-migration`** - Pages Router to App Router migration\n- **`nextjs-security`** - Authentication, CSP, OWASP compliance\n- **`nextjs-debugging`** - React DevTools and troubleshooting\n- **`nextjs-typescript`** - Type safety and error resolution\n\n#### Next.js Commands (6 total)\n\n```bash\n\u002Fcreate-page [route]          # Generate page with loading\u002Ferror boundaries\n\u002Fcreate-server-action [name]  # Create type-safe Server Actions\n\u002Foptimize-components          # Analyze component boundaries\n\u002Fsetup-testing [framework]    # Configure testing framework\n\u002Fanalyze-performance          # Generate performance report\n\u002Fmigrate-to-app-router        # Migrate from Pages Router\n```\n\n#### Key Features\n\n- **React 19 & Async Request APIs** - Full support for Next.js 15 breaking changes\n- **Server Components First** - Optimized for minimal client JavaScript\n- **Intelligent Validation** - Pre-commit hooks for Next.js patterns\n- **Best Practices Enforcement** - Automated checks for common mistakes\n- **Complete Documentation** - CLAUDE.md with Next.js 15 patterns\n\n## 🛠️ Featured Commands\n\n### Memory MCP Server Commands\n\n```bash\n\u002Fsetup quick       # Quick MCP project setup\n\u002Fsetup full        # Complete environment with dependencies\n\u002Fsetup database    # PostgreSQL & pgvector initialization\n\u002Fmcp-debug        # Debug MCP protocol issues\n\u002Fmemory-ops       # Test memory CRUD operations\n```\n\n### Next.js 15 Commands\n\n```bash\n\u002Fcreate-page              # Generate page with boundaries\n\u002Fcreate-server-action     # Create type-safe Server Actions\n\u002Foptimize-components      # Analyze component boundaries\n\u002Fanalyze-performance      # Generate performance report\n\u002Fmigrate-to-app-router    # Migrate from Pages Router\n```\n\n## ⚡ Shared Features\n\n### Automation Hooks\n\nBoth configurations include intelligent hooks:\n\n- **TypeScript Development** - Auto type-check, format, lint\n- **Command Logging** - Audit trail with timestamps\n- **Smart Filtering** - Skip node_modules, build directories\n- **Test Automation** - Run tests on file changes\n\n### Security Best Practices\n\nAll configurations enforce:\n\n- 🔒 **Whitelist approach** for commands\n- 🚫 **Protected sensitive files** (.env, secrets)\n- ✅ **Scoped write permissions** by file type\n- 🛡️ **Safe git operations** (no force push)\n- 🔐 **Input validation** with Zod schemas\n\n## 💡 Use Cases & Examples\n\n### 1. Memory MCP Server Development\n\nUse the memory-mcp-server configuration for:\n\n- Building MCP servers with persistent memory storage\n- Implementing vector search with pgvector and OpenAI embeddings\n- Creating multi-tenant AI companion systems\n- Setting up production PostgreSQL with Neon\n- Deploying with Docker and Kubernetes\n\n### 2. Next.js 15 Application Development\n\nUse the nextjs-15 configuration for:\n\n- Setting up new Next.js 15 projects with best practices\n- Migrating from Pages Router to App Router\n- Implementing Server Components and Server Actions\n- Optimizing performance and Core Web Vitals\n- Setting up comprehensive testing\n- Deploying to Vercel, Docker, or AWS\n\n### Production Deployment Pipeline\n\nLeverage deployment agents for:\n\n- Docker containerization with security hardening\n- Kubernetes orchestration with auto-scaling\n- Prometheus\u002FGrafana monitoring setup\n- Structured logging and distributed tracing\n\n### AI Companion Development\n\nBuild multi-tenant companion systems with:\n\n- Isolated memory spaces per user\n- Token-based authentication\n- Rate limiting and quota management\n- Conversation history with vector search\n\n## 📊 What You Get\n\n### Complete .claude Directory Structure\n\n```text\n.claude\u002F\n├── CLAUDE.md           # Combined best practices\n├── .claude\u002F\n│   ├── settings.json   # Merged settings\n│   ├── agents\u002F         # Framework-specific agents\n│   ├── commands\u002F       # Custom commands\n│   └── hooks\u002F          # Automation scripts\n├── README.md           # Setup instructions\n└── package.json        # Dependencies\n```\n\n### Example: Full-Stack Next.js\n\nGenerating a `nextjs-15 shadcn tailwindcss drizzle vercel-ai-sdk` config gives you:\n\n- **40+ specialized agents** across all frameworks\n- **25+ custom commands** for complete workflows\n- **Intelligent merging** without duplication\n- **Production-ready patterns** for modern web apps\n- **Type-safe development** from database to AI\n\n### Key Configuration Patterns\n\n#### Environment Variables (Placeholder Examples)\n\n```json\n\"env\": {\n  \"DATABASE_URL\": \"postgresql:\u002F\u002Fuser:pass@host\u002Fdbname?sslmode=require\",\n  \"OPENAI_API_KEY\": \"sk-your-openai-api-key-here\",\n  \"MCP_SERVER_PORT\": \"3000\"\n}\n```\n\n#### Hook Configuration\n\n```json\n\"hooks\": {\n  \"PostToolUse\": [{\n    \"matcher\": \"Edit|MultiEdit|Write\",\n    \"hooks\": [{\n      \"type\": \"command\",\n      \"command\": \"$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftypescript-dev.sh\"\n    }]\n  }]\n}\n```\n\n## 📊 Configuration Statistics\n\n### Memory MCP Server Configuration\n\n- **15 Specialized Agents** - ~15,000 lines of domain expertise\n- **7 Custom Commands** - Full development lifecycle coverage\n- **2 Automation Hooks** - TypeScript and logging automation\n- **Focus Areas:** MCP protocol, vector search, memory systems, production deployment\n\n### Next.js 15 Configuration\n\n- **11 Next.js Agents** - Framework-specific expertise\n- **6 Workflow Commands** - Next.js development automation\n- **Intelligent Hooks** - Validation and formatting\n- **Focus Areas:** App Router, Server Components, performance, testing\n\n## 🔗 Technology Stack\n\nThis configuration is optimized for:\n\n### General Development\n\n- **TypeScript** & Node.js development\n- **PostgreSQL 17** with **Neon** serverless\n- **Drizzle ORM v0.44.4** for type-safe database access\n- **pgvector v0.8.0** for vector similarity search\n- **MCP SDK** for protocol implementation\n- **Docker** & **Kubernetes** for deployment\n\n### Framework Support\n\n- **Next.js 15** with App Router\n- **React 19** with Server Components\n- **Tailwind CSS** for styling\n- **Server Actions** for mutations\n- **Turbopack** for faster builds\n\n## 📈 Benefits of This Configuration\n\n1. **🚀 10x Faster Development** - Specialized agents handle complex tasks\n2. **🛡️ Enhanced Security** - Multi-layered permission controls\n3. **🤖 Automated Workflows** - Hooks handle routine tasks\n4. **📚 Built-in Expertise** - Deep domain knowledge in agents\n5. **🔧 Production-Ready** - Deployment and monitoring included\n6. **🧪 Quality Assurance** - Automated testing and review\n\n## 🤝 Contributing\n\n**We welcome open-source contributions!** This repository thrives on community input to support more frameworks and use cases.\n\n### How to Contribute\n\n1. **Add a New Framework Configuration:**\n   - Create a new directory (e.g., `vercel-ai-sdk\u002F`, `drizzle\u002F`, `zod\u002F`)\n   - Include `.claude\u002F` directory with agents, commands, hooks, and settings\n   - Add a comprehensive `CLAUDE.md` with framework-specific best practices\n   - Create a `README.md` documenting the configuration\n\n2. **Improve Existing Configurations:**\n   - Add specialized agents for new use cases\n   - Create workflow commands for common tasks\n   - Enhance automation hooks\n   - Improve security patterns\n\n3. **Help Build the CLI Tool:**\n   - Contribute to the configuration generator logic\n   - Add framework detection capabilities\n   - Create configuration templates\n   - Improve the interactive setup experience\n\n### Testing the CLI Tool Locally\n\nWhen developing the composer, test your changes:\n\n```bash\n# From claude-config-composer directory\nnpm run dev nextjs-15 shadcn              # Test with tsx (TypeScript)\nnpm run build && npm run test             # Build and run tests\nnode dist\u002Fcli.js nextjs-15 shadcn         # Test built version\n```\n\n### Available Configurations ✅\n\n- **Next.js 15** ✅ - App Router, React 19, Server Components\n- **shadcn\u002Fui** ✅ - Radix UI components with Tailwind CSS\n- **Tailwind CSS** ✅ - Utility classes, responsive design, dark mode\n- **Vercel AI SDK** ✅ - Streaming, function calling, provider management\n- **Drizzle ORM** ✅ - Schema management, migrations, type safety\n- **Memory MCP Server** ✅ - Vector search and memory persistence\n- **Token-Gated MCP** ✅ - Secure MCP server with authentication\n\n### Coming Soon 🚧\n\n- **Prisma** - Alternative ORM with different patterns\n- **Zod** - Validation schemas and type generation\n- **Vitest** - Fast testing framework configuration\n- **Supabase** - Backend-as-a-Service setup\n- **tRPC** - End-to-end type safety, API patterns\n- **React 19** - Standalone React patterns and hooks\n\n### Contribution Guidelines\n\n- Follow the existing structure and patterns\n- Include comprehensive documentation\n- Test configurations thoroughly\n- Add examples of real-world usage\n- Ensure security best practices\n\n## 📝 License\n\nThis configuration reference is provided as-is for educational purposes. Adapt and modify for your specific needs.\n\n## ⚠️ Important Notes\n\n1. **Reference Only** - This repository is for learning, not direct cloning\n2. **Placeholder Values** - All credentials are examples only\n3. **Customize for Your Needs** - Adapt patterns to your specific workflow\n4. **Security First** - Always review and adjust permissions for your environment\n\n## 🎓 Learning Path\n\n1. **Start Simple** - Begin with `settings.json` permissions\n2. **Add Commands** - Implement one custom command\n3. **Integrate Agents** - Add relevant specialized agents\n4. **Automate** - Set up hooks for your workflow\n5. **Iterate** - Refine based on your experience\n\n---\n\n**Built with ❤️ for the Claude Code community**\n\n*Transform your AI-assisted development with production-grade configurations*\n\n🌟 **Star this repo** if you find it helpful!  \n🐛 **Open an issue** for bugs or suggestions  \n🚀 **Submit a PR** to add your framework configuration\n","# 🚀 Claude Code 配置\n\n[![NPM 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fclaude-config-composer)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fclaude-config-composer)\n[![NPM 下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fclaude-config-composer)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fclaude-config-composer)\n[![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMatt-Dionis\u002Fclaude-code-configs)](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green)](LICENSE)\n[![测试](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Node.js 版本](https:\u002F\u002Fimg.shields.io\u002Fnode\u002Fv\u002Fclaude-config-composer)](https:\u002F\u002Fnodejs.org)\n\n> **适用于流行框架和工具的生产就绪型 Claude Code 配置**\n\n🎉 **版本 1.0.0** - 生产就绪，经过全面测试，共有 124 个通过的测试用例\n📦 **NPM 包** - 可使用 `npm install -g claude-config-composer` 进行安装，或直接使用 `npx`\n\n## 🚨 **现有用户的重大变更**\n\n**本次发布从根本上改变了配置的组织和使用方式。**\n\n- ✅ **迁移指南已提供：** [MIGRATION.md](MIGRATION.md)\n- 🔄 单个配置文件已被移至 `configurations\u002F` 目录\n- 🎯 新的 CLI 工具用于智能合并配置\n- ⚠️ 直接复制目录的方式已被弃用\n\n## 🎯 核心特性\n\n- ✅ **124 个通过的测试用例** - 全面的测试覆盖率\n- ✅ **8+ 种生产级配置** - 涵盖框架、UI 库、数据库、MCP 服务器及开发工具\n- ✅ **智能合并** - 能够无冲突地组合多个配置\n- ✅ **运行时零依赖** - 轻量且高效\n- ✅ **TypeScript** - 完整的类型安全与现代化开发体验\n- ✅ **Git 集成** - 自动更新 `.gitignore` 文件并进行备份\n\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b407973-4148-49e3-872f-ce3f9a3161f8\n\n\n### 报告问题\n\n发现 bug？请在 [GitHub Issues](https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs\u002Fissues) 上提交。\n\n## 🎯 使用本仓库的两种方式\n\n### 1. 🚀 生成组合配置（推荐）\n\n**使用 NPX 快速开始（无需安装）：**\n\n```bash\n# 直接在项目中生成配置\nnpx claude-config-composer nextjs-15 shadcn\n\n# 或者使用交互模式\nnpx claude-config-composer\n```\n\n**全局安装：**\n\n```bash\n# 如果经常使用，可全局安装\nnpm install -g claude-config-composer\n\n# 然后可在任何项目中使用\nclaude-compose nextjs-15 shadcn tailwindcss\n```\n\n**本地开发（面向贡献者）：**\n\n```bash\n# 克隆并设置 composer\ngit clone https:\u002F\u002Fgithub.com\u002FMatt-Dionis\u002Fclaude-code-configs.git\ncd claude-code-configs\u002Fclaude-config-composer\nnpm install && npm run build\n\n# 在项目目录中生成配置\ncd \u002Fpath\u002Fto\u002Fyour\u002Fproject\nnode \u002Fpath\u002Fto\u002Fclaude-code-configs\u002Fclaude-config-composer\u002Fdist\u002Fcli.js nextjs-15 shadcn\n```\n\n**✨ 功能特点：**\n\n- 智能合并多个配置\n- 自动备份现有配置\n- 对 Git 友好（自动添加到 `.gitignore`）\n- 生产就绪的输出\n- 无需额外安装（一旦发布到 npm）\n\n### 2. 📁 手动复制单个配置\n\n**适用于单一框架的场景：**\n\n```bash\n# 将特定配置复制到您的项目中\ncp -r configurations\u002Fframeworks\u002Fnextjs-15\u002F.claude your-project\u002F\ncp configurations\u002Fframeworks\u002Fnextjs-15\u002FCLAUDE.md your-project\u002F\n```\n\n**可用配置：**\n\n**框架：**\n\n- `nextjs-15` - Next.js 15，支持 App Router 和 React 19\n\n**UI 与样式：**\n\n- `shadcn` - 基于 Radix UI 的 shadcn\u002Fui 组件库\n- `tailwindcss` - 实用优先的 CSS 框架，支持响应式设计\n\n**数据库：**\n\n- `drizzle` - 类型安全的 ORM，支持模式管理和迁移\n\n**开发工具：**\n\n- `vercel-ai-sdk` - 支持函数调用的流式 AI 应用程序\n\n**MCP 服务器（完整解决方案）：**\n\n- `memory-mcp-server` - 带有向量搜索和持久化功能的 MCP 服务器\n- `token-gated-mcp-server` - 使用 [Radius MCP SDK](https:\u002F\u002Fgithub.com\u002Fradiustechsystems\u002Fmcp-sdk) 的令牌授权 MCP 服务器\n\n## 📸 生成的内容示例 - 修改前后对比\n\n### 修改前：空项目目录\n\n```\nyour-nextjs-project\u002F\n├── app\u002F\n├── components\u002F\n├── package.json\n└── next.config.js\n```\n\n### 修改后：运行 `npx claude-config-composer nextjs-15 shadcn tailwindcss`\n\n```\nyour-nextjs-project\u002F\n├── app\u002F\n├── components\u002F\n├── package.json\n├── next.config.js\n├── CLAUDE.md                   # ✨ 结合所有配置的最佳实践\n└── .claude\u002F                    # ✨ 生成的配置文件\n    ├── agents\u002F\n    │   ├── nextjs-app-router.md         # Next.js 路由专家建议\n    │   ├── component-builder.md         # shadcn 组件模式\n    │   ├── responsive-designer.md       # Tailwind 响应式设计\n    │   └── ... (20+ 更专业的代理)\n    ├── commands\u002F\n    │   ├── create-page.md               # 生成 Next.js 页面\n    │   ├── add-component.md             # 添加 shadcn 组件\n    │   ├── optimize-styles.md           # Tailwind 样式优化\n    │   └── ... (15+ 工作流程命令)\n    ├── hooks\u002F\n    │   ├── format-code.sh               # 保存时自动格式化代码\n    │   ├── validate-components.sh       # 组件有效性检查\n    │   └── optimize-imports.sh          # 优化导入语句\n    └── settings.json                    # 合并后的权限与环境变量\n```\n\n### 🎯 生成配置的主要优势\n\n- **40+ 个专业代理**，覆盖 Next.js、shadcn 和 Tailwind 的专业知识\n- **智能权限控制**，根据您的技术栈量身定制\n- **自动化工作流程**，通过钩子实现格式化、验证和优化\n- **零冲突** - 所有配置被智能合并\n- **生产就绪** - 可立即与 Claude Code 配合使用\n\n## 📁 仓库结构\n\n```text\nclaude-config-composer\u002F         # 🔧 动态配置生成器 CLI 工具\n├── src\u002F\n│   ├── cli.ts                 # 交互式 CLI 界面\n│   ├── parser\u002F                # 配置解析逻辑\n│   ├── merger\u002F                # 智能合并\n│   └── generator\u002F             # .claude 目录生成\n└── README.md                  # 工具文档\n\nconfigurations\u002F                 # 📦 所有 Claude Code 配置\n├── frameworks\u002F                 # 框架特定配置\n│   └── nextjs-15\u002F             # Next.js 15 与 App Router 和 React 19\n│       ├── .claude\u002F           # 包含代理、命令、钩子的完整配置\n│       ├── CLAUDE.md          # Next.js 15 开发模式\n│       └── README.md          # 设置与使用指南\n├── ui\u002F                        # UI 库和样式配置\n│   ├── shadcn\u002F                # shadcn\u002Fui 组件库\n│   │   ├── .claude\u002F           # UI 开发代理和命令\n│   │   ├── CLAUDE.md          # 组件模式与最佳实践\n│   │   └── README.md          # 安装与设置指南\n│   └── tailwindcss\u002F           # 实用优先的 CSS 框架\n│       ├── .claude\u002F           # 样式与设计系统代理\n│       ├── CLAUDE.md          # Tailwind 模式与优化\n│       └── README.md          # 配置与使用指南\n├── databases\u002F                  # 数据库与 ORM 配置\n│   └── drizzle\u002F               # 类型安全的 ORM 及迁移工具\n│       ├── .claude\u002F           # 数据库开发代理\n│       ├── CLAUDE.md          # 模式管理与查询模式\n│       └── README.md          # 设置与迁移指南\n├── tooling\u002F                   # 开发工具与 SDK\n│   └── vercel-ai-sdk\u002F         # AI 应用开发\n│       ├── .claude\u002F           # AI 开发代理与工作流\n│       ├── CLAUDE.md          # 流式传输与函数调用模式\n│       └── README.md          # SDK 设置与使用指南\n└── mcp-servers\u002F               # 完整的 MCP 服务器解决方案\n    ├── memory-mcp-server\u002F     # 支持内存的 MCP 服务器\n    │   ├── .claude\u002F           # 全栈开发代理\n    │   ├── CLAUDE.md          # 向量搜索与持久化模式\n    │   └── README.md          # 完整的设置指南\n    └── token-gated-mcp-server\u002F # 支持认证的 MCP 服务器\n        ├── .claude\u002F           # 安全与认证代理\n        ├── CLAUDE.md          # 令牌管理和安全模式\n        └── README.md          # 认证设置指南\n\ndocs\u002F                          # 📚 文档与指南\n├── claude-code-github-actions.md\n├── claude-code-sdk.md\n├── get-started-with-claude-code-hooks.md\n└── [其他文档文件]\n\n# 🚧 即将推出：\n# configurations\u002F\n# ├── frameworks\u002F\n# │   ├── react-19\u002F           # 独立的 React 19 模式\n# │   └── svelte-5\u002F           # SvelteKit 2.0 配置\n# ├── databases\u002F\n# │   ├── prisma\u002F             # 替代 ORM 配置\n# │   └── supabase\u002F           # 后端即服务设置\n# ├── testing\u002F\n# │   ├── vitest\u002F             # 快速测试框架\n# │   └── playwright\u002F         # 端到端测试配置\n# └── tooling\u002F\n#     ├── zod\u002F                # 模式验证模式\n#     └── trpc\u002F               # 端到端类型安全\n```\n\n## 🚀 使用 Claude Config Composer 快速入门\n\n### 安装与使用\n\n```bash\n# 使用 npx 快速启动（无需安装）\nnpx claude-config-composer nextjs-15 shadcn tailwindcss\n\n# 或者全局安装\nnpm install -g claude-config-composer\n\n# 然后使用简短别名\nclaude-compose nextjs-15 shadcn\n```\n\n### 常用命令\n\n```bash\n# 交互模式 - 可视化选择配置\nnpx claude-config-composer\n\n# 列出所有可用配置\nnpx claude-config-composer list\n\n# 生成全栈配置\nnpx claude-config-composer nextjs-15 shadcn tailwindcss drizzle vercel-ai-sdk\n\n# AI 开发栈\nnpx claude-config-composer vercel-ai-sdk drizzle\n\n# 预览而不创建文件\nnpx claude-config-composer dry-run nextjs-15 shadcn\n\n# 验证现有配置\nnpx claude-config-composer validate\n```\n\n### 生成的内容\n\n在您的项目中会生成一个完整的 `.claude\u002F` 目录，包含：\n\n- 来自所有选定配置的组合代理\n- 合并后的命令和钩子\n- 统一的 settings.json\n- 详尽的 CLAUDE.md 文档\n\n## 🎯 可用配置\n\n### 内存 MCP 服务器配置\n\n用于构建具有内存持久化和向量搜索功能的生产级 MCP 服务器的配置：\n\n- **15 个专用代理**，分别用于 MCP、数据库和内存系统\n- **7 个自定义命令**，用于开发工作流\n- **2 个自动化钩子**，用于 TypeScript 和日志记录\n- **优化目标：** PostgreSQL 17、pgvector、Drizzle ORM、MCP SDK\n\n[查看内存 MCP 服务器详情 →](.\u002Fconfigurations\u002Fmcp-servers\u002Fmemory-mcp-server\u002FREADME.md)\n\n## 🎯 框架特定配置\n\n### Next.js 15 配置\n\n专为 Next.js 15 开发设计的完整 Claude Code 配置，包括：\n\n#### 专门的 Next.js 代理（共 11 个）\n\n**核心开发：**\n\n- **`nextjs-app-router`** - App Router 路由模式与最佳实践\n- **`nextjs-server-components`** - 服务器\u002F客户端组件优化\n- **`nextjs-server-actions`** - 表单、变更操作及渐进增强\n- **`nextjs-data-fetching`** - 缓存策略与流式传输\n- **`nextjs-performance`** - 包分析与 Core Web Vitals\n\n**基础设施与质量：**\n\n- **`nextjs-testing`** - Jest、Vitest、Playwright 的设置\n- **`nextjs-deployment`** - Docker、Vercel、AWS 部署\n- **`nextjs-migration`** - Pages Router 到 App Router 的迁移\n- **`nextjs-security`** - 认证、CSP、OWASP 合规性\n- **`nextjs-debugging`** - React DevTools 与故障排除\n- **`nextjs-typescript`** - 类型安全与错误解决\n\n#### Next.js 命令（共 6 个）\n\n```bash\n\u002Fcreate-page [route]          # 生成带有加载\u002F错误边界页面\n\u002Fcreate-server-action [name]  # 创建类型安全的 Server Actions\n\u002Foptimize-components          # 分析组件边界\n\u002Fsetup-testing [framework]    # 配置测试框架\n\u002Fanalyze-performance          # 生成性能报告\n\u002Fmigrate-to-app-router        # 从 Pages Router 迁移\n```\n\n#### 关键特性\n\n- **React 19 与异步请求 API** -  volle Unterstützung der Breaking Changes von Next.js 15\n- **服务器组件优先** - 优化以减少客户端 JavaScript\n- **智能验证** - 提交前钩子用于 Next.js 模式检查\n- **最佳实践强制执行** - 自动化检查常见错误\n- **完整文档** - CLAUDE.md 包含 Next.js 15 模式\n\n## 🛠️ 特色命令\n\n### 内存 MCP 服务器命令\n\n```bash\n\u002Fsetup quick       # 快速设置 MCP 项目\n\u002Fsetup full        # 完整环境及依赖项安装\n\u002Fsetup database    # 初始化 PostgreSQL 和 pgvector\n\u002Fmcp-debug        # 调试 MCP 协议问题\n\u002Fmemory-ops       # 测试内存的 CRUD 操作\n```\n\n### Next.js 15 命令\n\n```bash\n\u002Fcreate-page              # 生成带有边界划分的页面\n\u002Fcreate-server-action     # 创建类型安全的 Server Actions\n\u002Foptimize-components      # 分析组件边界\n\u002Fanalyze-performance      # 生成性能报告\n\u002Fmigrate-to-app-router    # 从 Pages Router 迁移至 App Router\n```\n\n## ⚡ 共享功能\n\n### 自动化钩子\n\n两种配置均包含智能钩子：\n\n- **TypeScript 开发**：自动进行类型检查、格式化和 lint 检查\n- **命令日志记录**：带时间戳的审计追踪\n- **智能过滤**：跳过 node_modules 和构建目录\n- **测试自动化**：文件更改时自动运行测试\n\n### 安全最佳实践\n\n所有配置均强制执行以下措施：\n\n- 🔒 **白名单机制**：仅允许特定命令\n- 🚫 **保护敏感文件**（如 .env、secrets）\n- ✅ **按文件类型限制写入权限**\n- 🛡️ **安全的 Git 操作**（禁止强制推送）\n- 🔐 **输入验证**：使用 Zod 架构进行验证\n\n## 💡 使用场景与示例\n\n### 1. 内存 MCP 服务器开发\n\n使用 memory-mcp-server 配置可实现：\n\n- 构建具有持久化内存存储的 MCP 服务器\n- 结合 pgvector 和 OpenAI 嵌入向量实现向量搜索\n- 创建多租户 AI 助手系统\n- 设置生产级 PostgreSQL 数据库（如 Neon）\n- 通过 Docker 和 Kubernetes 部署应用\n\n### 2. Next.js 15 应用开发\n\n使用 nextjs-15 配置可实现：\n\n- 按照最佳实践搭建新的 Next.js 15 项目\n- 从 Pages Router 迁移到 App Router\n- 实现 Server Components 和 Server Actions\n- 优化性能和 Core Web Vitals\n- 搭建全面的测试体系\n- 部署至 Vercel、Docker 或 AWS\n\n### 生产部署流水线\n\n借助部署代理可实现：\n\n- 使用安全加固技术进行 Docker 容器化\n- 通过 Kubernetes 进行自动扩缩容编排\n- 部署 Prometheus\u002FGrafana 监控系统\n- 实施结构化日志记录和分布式追踪\n\n### AI 助手开发\n\n构建多租户助手系统时，可采用：\n\n- 为每个用户隔离独立的内存空间\n- 基于令牌的身份认证\n- 速率限制和配额管理\n- 利用向量搜索实现对话历史记录\n\n## 📊 您将获得的内容\n\n### 完整的 .claude 目录结构\n\n```text\n.claude\u002F\n├── CLAUDE.md           # 综合最佳实践文档\n├── .claude\u002F\n│   ├── settings.json   # 合并后的配置文件\n│   ├── agents\u002F         # 框架专属代理\n│   ├── commands\u002F       # 自定义命令\n│   └── hooks\u002F          # 自动化脚本\n├── README.md           # 设置说明\n└── package.json        # 依赖项列表\n```\n\n### 示例：全栈 Next.js 项目\n\n生成 `nextjs-15 shadcn tailwindcss drizzle vercel-ai-sdk` 配置后，您将获得：\n\n- **40 多个专用代理**，覆盖所有相关框架\n- **25 多条自定义命令**，支持完整工作流程\n- **智能合并功能**，避免重复\n- **适用于生产环境的模式**，用于现代 Web 应用开发\n- **类型安全的开发体验**，从数据库到 AI 技术全覆盖\n\n### 关键配置模式\n\n#### 环境变量（示例）\n\n```json\n\"env\": {\n  \"DATABASE_URL\": \"postgresql:\u002F\u002Fuser:pass@host\u002Fdbname?sslmode=require\",\n  \"OPENAI_API_KEY\": \"sk-your-openai-api-key-here\",\n  \"MCP_SERVER_PORT\": \"3000\"\n}\n```\n\n#### 钩子配置\n\n```json\n\"hooks\": {\n  \"PostToolUse\": [{\n    \"matcher\": \"Edit|MultiEdit|Write\",\n    \"hooks\": [{\n      \"type\": \"command\",\n      \"command\": \"$CLAUDE_PROJECT_DIR\u002F.claude\u002Fhooks\u002Ftypescript-dev.sh\"\n    }]\n  }]\n}\n```\n\n## 📊 配置统计信息\n\n### 内存 MCP 服务器配置\n\n- **15 个专用代理**：约 15,000 行领域专业知识\n- **7 条自定义命令**：覆盖完整的开发生命周期\n- **2 个自动化钩子**：实现 TypeScript 和日志记录自动化\n- **重点领域**：MCP 协议、向量搜索、内存系统、生产部署\n\n### Next.js 15 配置\n\n- **11 个 Next.js 代理**：框架专属专业知识\n- **6 条工作流命令**：实现 Next.js 开发自动化\n- **智能钩子**：用于验证和格式化\n- **重点领域**：App Router、Server Components、性能优化、测试\n\n## 🔗 技术栈\n\n此配置针对以下技术进行了优化：\n\n### 通用开发\n\n- TypeScript 和 Node.js 开发\n- PostgreSQL 17 结合 Neon 无服务器服务\n- Drizzle ORM v0.44.4，提供类型安全的数据库访问\n- pgvector v0.8.0，用于向量相似度搜索\n- MCP SDK，用于协议实现\n- Docker 和 Kubernetes，用于应用部署\n\n### 框架支持\n\n- Next.js 15 及其 App Router\n- React 19 与 Server Components\n- Tailwind CSS 用于样式设计\n- Server Actions 用于数据变更操作\n- Turbopack 用于加速构建过程\n\n## 📈 此配置的优势\n\n1. **🚀 开发速度提升 10 倍**：专用代理负责处理复杂任务\n2. **🛡️ 更强的安全性**：多层权限控制机制\n3. **🤖 自动化工作流程**：钩子自动完成常规任务\n4. **📚 内置专业知识**：代理具备深厚的领域知识\n5. **🔧 生产就绪**：包含部署和监控功能\n6. **🧪 质量保证**：自动化测试与评审流程\n\n## 🤝 贡献方式\n\n**我们欢迎开源贡献！** 本仓库依靠社区力量不断扩展对更多框架和应用场景的支持。\n\n### 如何贡献\n\n1. **添加新框架配置**：\n   - 创建新目录（如 `vercel-ai-sdk\u002F`、`drizzle\u002F`、`zod\u002F`）\n   - 在其中加入 `.claude\u002F` 目录，包含代理、命令、钩子和设置\n   - 编写详细的 `CLAUDE.md` 文件，介绍该框架的最佳实践\n   - 创建 `README.md` 文档，说明配置的具体内容\n\n2. **改进现有配置**：\n   - 为新用例添加专用代理\n   - 创建常用任务的工作流命令\n   - 优化自动化钩子\n   - 提升安全防护模式\n\n3. **协助开发 CLI 工具**：\n   - 参与配置生成器逻辑的开发\n   - 增加框架检测功能\n   - 创建配置模板\n   - 改善交互式设置体验\n\n### 本地测试 CLI 工具\n\n在开发配置生成器时，请按以下步骤测试您的更改：\n\n```bash\n# 从 claude-config-composer 目录下\nnpm run dev nextjs-15 shadcn              # 使用 tsx（TypeScript）测试\nnpm run build && npm run test             # 构建并运行测试\nnode dist\u002Fcli.js nextjs-15 shadcn         # 测试已构建版本\n```\n\n### 可用配置 ✅\n\n- **Next.js 15** ✅：App Router、React 19、Server Components\n- **shadcn\u002Fui** ✅：结合 Tailwind CSS 的 Radix UI 组件\n- **Tailwind CSS** ✅：实用类、响应式设计、暗黑模式\n- **Vercel AI SDK** ✅：流式传输、函数调用、提供商管理\n- **Drizzle ORM** ✅：模式管理、迁移、类型安全\n- **内存 MCP 服务器** ✅：向量搜索与内存持久化\n- **基于令牌的 MCP 服务器** ✅：带身份验证的安全 MCP 服务器\n\n### 即将推出 🚧\n\n- **Prisma** - 具有不同模式的替代 ORM\n- **Zod** - 验证模式与类型生成\n- **Vitest** - 快速测试框架配置\n- **Supabase** - 后端即服务搭建\n- **tRPC** - 端到端类型安全、API 模式\n- **React 19** - 独立 React 模式与钩子\n\n### 贡献指南\n\n- 遵循现有结构和模式\n- 包含全面的文档\n- 彻底测试配置\n- 添加实际使用示例\n- 确保遵循安全最佳实践\n\n## 📝 许可证\n\n本配置参考按“原样”提供，仅用于教育目的。请根据您的具体需求进行调整和修改。\n\n## ⚠️ 重要提示\n\n1. **仅供参考** - 此仓库仅用于学习，不可直接克隆\n2. **占位符值** - 所有凭据仅为示例\n3. **根据需求定制** - 将模式适配到您的特定工作流\n4. **安全第一** - 始终检查并调整您环境中的权限设置\n\n## 🎓 学习路径\n\n1. **从简单开始** - 从 `settings.json` 权限入手\n2. **添加命令** - 实现一个自定义命令\n3. **集成代理** - 添加相关专业代理\n4. **自动化** - 为您的工作流设置钩子\n5. **迭代优化** - 根据经验不断改进\n\n---\n\n**专为 Claude Code 社区用心打造**\n\n*用生产级配置变革您的 AI 辅助开发*\n\n🌟 如果您觉得有用，请给这个仓库点个星！  \n🐛 如发现 bug 或有建议，请提交 issue  \n🚀 如需添加您的框架配置，请提交 PR","# Claude Code Configs 快速上手指南\n\n`claude-code-configs` 是一个专为 Claude Code 设计的配置管理工具，提供针对主流框架（如 Next.js）、UI 库（shadcn）、数据库（Drizzle）及 MCP 服务器的生产级配置。它支持智能合并多个配置，避免冲突，并自动生成包含 Agents、命令和钩子的完整 `.claude` 目录。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Windows, macOS, 或 Linux\n*   **Node.js**：版本 18.0 或更高（推荐最新 LTS 版本）\n*   **包管理器**：npm, yarn, 或 pnpm\n*   **目标项目**：一个已初始化的代码项目目录\n\n> **国内加速建议**：\n> 如果访问 npm 官方源较慢，建议临时切换至国内镜像源（如淘宝镜像）：\n> ```bash\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\n您可以选择**免安装直接使用**或**全局安装**两种方式。\n\n### 方式一：免安装使用（推荐尝试）\n无需预先安装，通过 `npx` 直接运行最新版本的工具：\n\n```bash\nnpx claude-config-composer\n```\n\n### 方式二：全局安装（推荐高频使用）\n如果您需要频繁使用该工具，建议全局安装以获得更短的命令行别名：\n\n```bash\nnpm install -g claude-config-composer\n```\n\n安装完成后，您可以使用简写命令 `claude-compose`。\n\n## 基本使用\n\n### 1. 交互式模式（可视化选择）\n在项目根目录下运行以下命令，通过终端交互界面选择您需要的配置组合：\n\n```bash\nnpx claude-config-composer\n# 或者全局安装后\nclaude-compose\n```\n\n### 2. 命令行直接生成\n您也可以直接在命令后指定所需的配置名称，工具将自动智能合并这些配置并生成文件。\n\n**示例：为 Next.js 15 项目添加 shadcn\u002Fui 和 Tailwind CSS 支持**\n\n```bash\nnpx claude-config-composer nextjs-15 shadcn tailwindcss\n```\n\n**示例：构建全栈 AI 应用配置（Next.js + Drizzle + Vercel AI SDK）**\n\n```bash\nnpx claude-config-composer nextjs-15 drizzle vercel-ai-sdk\n```\n\n### 3. 生成结果\n执行成功后，当前项目目录下将自动生成\u002F更新以下内容：\n\n*   **`.claude\u002F` 目录**：包含合并后的专用 Agents（如路由专家、组件构建器）、工作流命令和自动化钩子。\n*   **`CLAUDE.md` 文件**：整合了所有选中配置的最佳实践文档。\n*   **自动备份**：如果存在旧配置，工具会自动进行备份。\n*   **Git 集成**：自动将 `.claude` 目录添加到 `.gitignore`（可选）。\n\n### 常用辅助命令\n\n```bash\n# 列出所有可用的配置项\nnpx claude-config-composer list\n\n# 预览将要生成的文件（不实际写入）\nnpx claude-config-composer dry-run nextjs-15 shadcn\n\n# 验证现有配置的有效性\nnpx claude-config-composer validate\n```","一位全栈开发者正急于在周末前搭建一个基于 Next.js 15、shadcn\u002Fui 组件库和 Drizzle ORM 的新项目原型，希望利用 Claude Code 加速开发流程。\n\n### 没有 claude-code-configs 时\n- **配置碎片化严重**：开发者需要手动去不同仓库寻找 Next.js、shadcn 和数据库的独立配置文件，花费大量时间拼凑 `.claude` 目录。\n- **规则冲突风险高**：手动合并多个框架的配置时，极易出现指令矛盾（如文件结构定义冲突），导致 AI 生成代码风格混乱或报错。\n- **环境适配耗时**：每次新建项目都要重复编写针对 React 19 或特定 ORM 的提示词上下文，无法实现“一次配置，多处复用”。\n- **缺乏版本保障**：自行维护的配置未经过系统测试，随着框架升级，旧配置可能失效且难以排查原因。\n\n### 使用 claude-code-configs 后\n- **一键智能组合**：只需运行 `npx claude-config-composer nextjs-15 shadcn drizzle`，工具自动将多套生产级配置无损合并到项目中。\n- **冲突自动消解**：内置的智能合并机制确保不同技术栈的规则和谐共存，输出统一、连贯的 AI 行为准则。\n- **开箱即用体验**：直接获得经过 124 项测试验证的配置方案，完美适配最新技术特性，无需任何手动调整。\n- **安全可控迭代**：自动生成配置备份并更新 `.gitignore`，让团队能放心地随框架升级同步更新 AI 配置。\n\nclaude-code-configs 将原本数小时的繁琐配置工作压缩为秒级命令，让开发者能立即专注于核心业务逻辑的实现。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMatt-Dionis_claude-code-configs_979dc212.png","Matt-Dionis","Matt Dionis","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMatt-Dionis_b210ece9.png","Software Engineer. Web3, AI\u002FML enthusiast. Mentor, family man, rock climber & weather geek. Driven to innovate & make an impact. 🚀🧠","Worcester, MA","mattdionis@gmail.com","https:\u002F\u002Fgithub.com\u002FMatt-Dionis",[83,87,91],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",75.8,{"name":88,"color":89,"percentage":90},"Shell","#89e051",21.9,{"name":92,"color":93,"percentage":94},"JavaScript","#f1e05a",2.3,626,80,"2026-04-14T09:29:08","MIT",1,"Linux, macOS, Windows","未说明",{"notes":103,"python":101,"dependencies":104},"该工具是基于 Node.js 的命令行配置生成器，用于为 Claude Code 生成项目配置文件。无需 GPU 或大量内存。主要运行环境需求为安装 Node.js 和 npm。可通过 'npx claude-config-composer' 直接运行或全局安装后使用。支持多种框架（如 Next.js 15）、UI 库（shadcn, Tailwind CSS）、数据库 ORM（Drizzle）及 MCP 服务器的配置合并。",[105,106],"Node.js (版本需符合 NPM 包要求)","claude-config-composer (NPM 包)",[15,25],"2026-03-27T02:49:30.150509","2026-04-15T11:00:32.035435",[],[112],{"id":113,"version":114,"summary_zh":115,"released_at":116},264131,"v1.0.0","# 🎉 Claude Config Composer v1.0.0 - 生产环境发布\n\n我们很高兴地宣布 Claude Code Configs 的正式 v1.0.0 版本发布！本次发布带来了彻底的架构革新，推出了全新的 `claude-config-composer` CLI 工具，能够智能地合并您开发栈中的配置。\n\n## 🚀 主要变更\n\n### 新 CLI 工具：claude-config-composer\n- **智能合并**：无缝整合多个配置文件，避免冲突\n- **交互模式**：可视化配置选择界面\n- **无需安装**：直接通过 `npx` 使用\n- **TypeScript 支持**：完全类型安全，符合现代开发规范\n- **118+ 项测试**：全面的测试覆盖\n\n### 仓库重构\n- 配置文件现按类别组织在 `configurations\u002F` 目录下\n- 单个配置文件增加了元数据和优先级设置\n- 文档和示例得到进一步优化\n\n## 📦 安装方式\n\n```bash\n# 快速启动（无需安装）：使用 npx\nnpx claude-config-composer nextjs-15 shadcn\n\n# 或者全局安装\nnpm install -g claude-config-composer\n\n# 安装后可使用简短别名\nclaude-compose nextjs-15 shadcn tailwindcss\n```","2025-08-24T14:38:37"]