[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-diet103--claude-code-infrastructure-showcase":3,"tool-diet103--claude-code-infrastructure-showcase":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},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"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 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":10,"last_commit_at":41,"category_tags":42,"status":16},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[13,14,15,43],"视频",{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":23,"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,26],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":23,"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 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,60,43,61,15,62,26,13,63],"数据工具","插件","其他","音频",{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":77,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":79,"languages":80,"stars":89,"forks":90,"last_commit_at":91,"license":92,"difficulty_score":23,"env_os":93,"env_gpu":94,"env_ram":93,"env_deps":95,"category_tags":101,"github_topics":77,"view_count":23,"oss_zip_url":77,"oss_zip_packed_at":77,"status":16,"created_at":102,"updated_at":103,"faqs":104,"releases":105},4214,"diet103\u002Fclaude-code-infrastructure-showcase","claude-code-infrastructure-showcase","Examples of my Claude Code infrastructure with skill auto-activation, hooks, and agents","claude-code-infrastructure-showcase 是一个经过生产环境验证的 Claude Code 基础设施参考库，旨在帮助开发者构建高效、可扩展的 AI 辅助开发工作流。它并非直接运行的应用程序，而是一套源自真实复杂 TypeScript 微服务项目实战经验的模式与系统集合。\n\n该方案核心解决了 Claude Code 技能（Skills）通常处于“被动等待”状态、需人工记忆调用的痛点。通过引入自定义钩子（Hooks）和智能配置，它能自动分析用户提示词与文件上下文，按需激活相关技能，实现“用时即现”。此外，针对大模型上下文限制，它创新性地提出了\"500 行规则”与渐进式披露机制，将大型技能拆解为主指南与资源模块，仅在需要时加载细节，有效避免了上下文溢出。\n\n这套工具特别适合正在使用或计划引入 Claude Code 进行企业级开发的软件工程师与技术团队。无论是需要自动化后端\u002F前端开发规范，还是希望定制专属 Agent 来处理代码架构审查、重构及调试等复杂任务，都能从中找到成熟的可复用模板。只需少量时间集成，即可将原本零散的 AI 交互升级为系统化、自动化的研发助","claude-code-infrastructure-showcase 是一个经过生产环境验证的 Claude Code 基础设施参考库，旨在帮助开发者构建高效、可扩展的 AI 辅助开发工作流。它并非直接运行的应用程序，而是一套源自真实复杂 TypeScript 微服务项目实战经验的模式与系统集合。\n\n该方案核心解决了 Claude Code 技能（Skills）通常处于“被动等待”状态、需人工记忆调用的痛点。通过引入自定义钩子（Hooks）和智能配置，它能自动分析用户提示词与文件上下文，按需激活相关技能，实现“用时即现”。此外，针对大模型上下文限制，它创新性地提出了\"500 行规则”与渐进式披露机制，将大型技能拆解为主指南与资源模块，仅在需要时加载细节，有效避免了上下文溢出。\n\n这套工具特别适合正在使用或计划引入 Claude Code 进行企业级开发的软件工程师与技术团队。无论是需要自动化后端\u002F前端开发规范，还是希望定制专属 Agent 来处理代码架构审查、重构及调试等复杂任务，都能从中找到成熟的可复用模板。只需少量时间集成，即可将原本零散的 AI 交互升级为系统化、自动化的研发助力，显著提升开发效率与代码质量。","# Claude Code Infrastructure Showcase\n\n**A curated reference library of production-tested Claude Code infrastructure.**\n\nBorn from 6 months of real-world use managing a complex TypeScript microservices project, this showcase provides the patterns and systems that solved the \"skills don't activate automatically\" problem and scaled Claude Code for enterprise development.\n\n> **This is NOT a working application** - it's a reference library. Copy what you need into your own projects.\n\n---\n\n## What's Inside\n\n**Production-tested infrastructure for:**\n- ✅ **Auto-activating skills** via hooks\n- ✅ **Modular skill pattern** (500-line rule with progressive disclosure)\n- ✅ **Specialized agents** for complex tasks\n- ✅ **Dev docs system** that survives context resets\n- ✅ **Comprehensive examples** using generic blog domain\n\n**Time investment to build:** 6 months of iteration\n**Time to integrate into your project:** 15-30 minutes\n\n---\n\n## Quick Start - Pick Your Path\n\n### 🤖 Using Claude Code to Integrate?\n\n**Claude:** Read [`CLAUDE_INTEGRATION_GUIDE.md`](CLAUDE_INTEGRATION_GUIDE.md) for step-by-step integration instructions tailored for AI-assisted setup.\n\n### 🎯 I want skill auto-activation\n\n**The breakthrough feature:** Skills that actually activate when you need them.\n\n**What you need:**\n1. The skill-activation hooks (2 files)\n2. A skill or two relevant to your work\n3. 15 minutes\n\n**👉 [Setup Guide: .claude\u002Fhooks\u002FREADME.md](.claude\u002Fhooks\u002FREADME.md)**\n\n### 📚 I want to add ONE skill\n\nBrowse the [skills catalog](.claude\u002Fskills\u002F) and copy what you need.\n\n**Available:**\n- **backend-dev-guidelines** - Node.js\u002FExpress\u002FTypeScript patterns\n- **frontend-dev-guidelines** - React\u002FTypeScript\u002FMUI v7 patterns\n- **skill-developer** - Meta-skill for creating skills\n- **route-tester** - Test authenticated API routes\n- **error-tracking** - Sentry integration patterns\n\n**👉 [Skills Guide: .claude\u002Fskills\u002FREADME.md](.claude\u002Fskills\u002FREADME.md)**\n\n### 🤖 I want specialized agents\n\n10 production-tested agents for complex tasks:\n- Code architecture review\n- Refactoring assistance\n- Documentation generation\n- Error debugging\n- And more...\n\n**👉 [Agents Guide: .claude\u002Fagents\u002FREADME.md](.claude\u002Fagents\u002FREADME.md)**\n\n---\n\n## What Makes This Different?\n\n### The Auto-Activation Breakthrough\n\n**Problem:** Claude Code skills just sit there. You have to remember to use them.\n\n**Solution:** UserPromptSubmit hook that:\n- Analyzes your prompts\n- Checks file context\n- Automatically suggests relevant skills\n- Works via `skill-rules.json` configuration\n\n**Result:** Skills activate when you need them, not when you remember them.\n\n### Production-Tested Patterns\n\nThese aren't theoretical examples - they're extracted from:\n- ✅ 6 microservices in production\n- ✅ 50,000+ lines of TypeScript\n- ✅ React frontend with complex data grids\n- ✅ Sophisticated workflow engine\n- ✅ 6 months of daily Claude Code use\n\nThe patterns work because they solved real problems.\n\n### Modular Skills (500-Line Rule)\n\nLarge skills hit context limits. The solution:\n\n```\nskill-name\u002F\n  SKILL.md                  # \u003C500 lines, high-level guide\n  resources\u002F\n    topic-1.md              # \u003C500 lines each\n    topic-2.md\n    topic-3.md\n```\n\n**Progressive disclosure:** Claude loads main skill first, loads resources only when needed.\n\n---\n\n## Repository Structure\n\n```\n.claude\u002F\n├── skills\u002F                 # 5 production skills\n│   ├── backend-dev-guidelines\u002F  (12 resource files)\n│   ├── frontend-dev-guidelines\u002F (11 resource files)\n│   ├── skill-developer\u002F         (7 resource files)\n│   ├── route-tester\u002F\n│   ├── error-tracking\u002F\n│   └── skill-rules.json    # Skill activation configuration\n├── hooks\u002F                  # 6 hooks for automation\n│   ├── skill-activation-prompt.*  (ESSENTIAL)\n│   ├── post-tool-use-tracker.sh   (ESSENTIAL)\n│   ├── tsc-check.sh        (optional, needs customization)\n│   └── trigger-build-resolver.sh  (optional)\n├── agents\u002F                 # 10 specialized agents\n│   ├── code-architecture-reviewer.md\n│   ├── refactor-planner.md\n│   ├── frontend-error-fixer.md\n│   └── ... 7 more\n└── commands\u002F               # 3 slash commands\n    ├── dev-docs.md\n    └── ...\n\ndev\u002F\n└── active\u002F                 # Dev docs pattern examples\n    └── public-infrastructure-repo\u002F\n```\n\n---\n\n## Component Catalog\n\n### 🎨 Skills (5)\n\n| Skill | Lines | Purpose | Best For |\n|-------|-------|---------|----------|\n| [**skill-developer**](.claude\u002Fskills\u002Fskill-developer\u002F) | 426 | Creating and managing skills | Meta-development |\n| [**backend-dev-guidelines**](.claude\u002Fskills\u002Fbackend-dev-guidelines\u002F) | 304 | Express\u002FPrisma\u002FSentry patterns | Backend APIs |\n| [**frontend-dev-guidelines**](.claude\u002Fskills\u002Ffrontend-dev-guidelines\u002F) | 398 | React\u002FMUI v7\u002FTypeScript | React frontends |\n| [**route-tester**](.claude\u002Fskills\u002Froute-tester\u002F) | 389 | Testing authenticated routes | API testing |\n| [**error-tracking**](.claude\u002Fskills\u002Ferror-tracking\u002F) | ~250 | Sentry integration | Error monitoring |\n\n**All skills follow the modular pattern** - main file + resource files for progressive disclosure.\n\n**👉 [How to integrate skills →](.claude\u002Fskills\u002FREADME.md)**\n\n### 🪝 Hooks (6)\n\n| Hook | Type | Essential? | Customization |\n|------|------|-----------|---------------|\n| skill-activation-prompt | UserPromptSubmit | ✅ YES | ✅ None needed |\n| post-tool-use-tracker | PostToolUse | ✅ YES | ✅ None needed |\n| tsc-check | Stop | ⚠️ Optional | ⚠️ Heavy - monorepo only |\n| trigger-build-resolver | Stop | ⚠️ Optional | ⚠️ Heavy - monorepo only |\n| error-handling-reminder | Stop | ⚠️ Optional | ⚠️ Moderate |\n| stop-build-check-enhanced | Stop | ⚠️ Optional | ⚠️ Moderate |\n\n**Start with the two essential hooks** - they enable skill auto-activation and work out of the box.\n\n**👉 [Hook setup guide →](.claude\u002Fhooks\u002FREADME.md)**\n\n### 🤖 Agents (10)\n\n**Standalone - just copy and use!**\n\n| Agent | Purpose |\n|-------|---------|\n| code-architecture-reviewer | Review code for architectural consistency |\n| code-refactor-master | Plan and execute refactoring |\n| documentation-architect | Generate comprehensive documentation |\n| frontend-error-fixer | Debug frontend errors |\n| plan-reviewer | Review development plans |\n| refactor-planner | Create refactoring strategies |\n| web-research-specialist | Research technical issues online |\n| auth-route-tester | Test authenticated endpoints |\n| auth-route-debugger | Debug auth issues |\n| auto-error-resolver | Auto-fix TypeScript errors |\n\n**👉 [How agents work →](.claude\u002Fagents\u002FREADME.md)**\n\n### 💬 Slash Commands (3)\n\n| Command | Purpose |\n|---------|---------|\n| \u002Fdev-docs | Create structured dev documentation |\n| \u002Fdev-docs-update | Update docs before context reset |\n| \u002Froute-research-for-testing | Research route patterns for testing |\n\n---\n\n## Key Concepts\n\n### Hooks + skill-rules.json = Auto-Activation\n\n**The system:**\n1. **skill-activation-prompt hook** runs on every user prompt\n2. Checks **skill-rules.json** for trigger patterns\n3. Suggests relevant skills automatically\n4. Skills load only when needed\n\n**This solves the #1 problem** with Claude Code skills: they don't activate on their own.\n\n### Progressive Disclosure (500-Line Rule)\n\n**Problem:** Large skills hit context limits\n\n**Solution:** Modular structure\n- Main SKILL.md \u003C500 lines (overview + navigation)\n- Resource files \u003C500 lines each (deep dives)\n- Claude loads incrementally as needed\n\n**Example:** backend-dev-guidelines has 12 resource files covering routing, controllers, services, repositories, testing, etc.\n\n### Dev Docs Pattern\n\n**Problem:** Context resets lose project context\n\n**Solution:** Three-file structure\n- `[task]-plan.md` - Strategic plan\n- `[task]-context.md` - Key decisions and files\n- `[task]-tasks.md` - Checklist format\n\n**Works with:** `\u002Fdev-docs` slash command to generate these automatically\n\n---\n\n## ⚠️ Important: What Won't Work As-Is\n\n### settings.json\nThe included `settings.json` is an **example only**:\n- Stop hooks reference specific monorepo structure\n- Service names (blog-api, etc.) are examples\n- MCP servers may not exist in your setup\n\n**To use it:**\n1. Extract ONLY UserPromptSubmit and PostToolUse hooks\n2. Customize or skip Stop hooks\n3. Update MCP server list for your setup\n\n### Blog Domain Examples\nSkills use generic blog examples (Post\u002FComment\u002FUser):\n- These are **teaching examples**, not requirements\n- Patterns work for any domain (e-commerce, SaaS, etc.)\n- Adapt the patterns to your business logic\n\n### Hook Directory Structures\nSome hooks expect specific structures:\n- `tsc-check.sh` expects service directories\n- Customize based on YOUR project layout\n\n---\n\n## Integration Workflow\n\n**Recommended approach:**\n\n### Phase 1: Skill Activation (15 min)\n1. Copy skill-activation-prompt hook\n2. Copy post-tool-use-tracker hook\n3. Update settings.json\n4. Install hook dependencies\n\n### Phase 2: Add First Skill (10 min)\n1. Pick ONE relevant skill\n2. Copy skill directory\n3. Create\u002Fupdate skill-rules.json\n4. Customize path patterns\n\n### Phase 3: Test & Iterate (5 min)\n1. Edit a file - skill should activate\n2. Ask a question - skill should be suggested\n3. Add more skills as needed\n\n### Phase 4: Optional Enhancements\n- Add agents you find useful\n- Add slash commands\n- Customize Stop hooks (advanced)\n\n---\n\n## Getting Help\n\n### For Users\n**Issues with integration?**\n1. Check [CLAUDE_INTEGRATION_GUIDE.md](CLAUDE_INTEGRATION_GUIDE.md)\n2. Ask Claude: \"Why isn't [skill] activating?\"\n3. Open an issue with your project structure\n\n### For Claude Code\nWhen helping users integrate:\n1. **Read CLAUDE_INTEGRATION_GUIDE.md FIRST**\n2. Ask about their project structure\n3. Customize, don't blindly copy\n4. Verify after integration\n\n---\n\n## What This Solves\n\n### Before This Infrastructure\n\n❌ Skills don't activate automatically\n❌ Have to remember which skill to use\n❌ Large skills hit context limits\n❌ Context resets lose project knowledge\n❌ No consistency across development\n❌ Manual agent invocation every time\n\n### After This Infrastructure\n\n✅ Skills suggest themselves based on context\n✅ Hooks trigger skills at the right time\n✅ Modular skills stay under context limits\n✅ Dev docs preserve knowledge across resets\n✅ Consistent patterns via guardrails\n✅ Agents streamline complex tasks\n\n---\n\n## Community\n\n**Found this useful?**\n\n- ⭐ Star this repo\n- 🐛 Report issues or suggest improvements\n- 💬 Share your own skills\u002Fhooks\u002Fagents\n- 📝 Contribute examples from your domain\n\n**Background:**\nThis infrastructure was detailed in a post I made to Reddit [\"Claude Code is a Beast – Tips from 6 Months of Hardcore Use\"](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FClaudeAI\u002Fcomments\u002F1oivjvm\u002Fclaude_code_is_a_beast_tips_from_6_months_of\u002F). After hundreds of requests, this showcase was created to help the community implement these patterns.\n\n\n---\n\n## License\n\nMIT License - Use freely in your projects, commercial or personal.\n\n---\n\n## Quick Links\n\n- 📖 [Claude Integration Guide](CLAUDE_INTEGRATION_GUIDE.md) - For AI-assisted setup\n- 🎨 [Skills Documentation](.claude\u002Fskills\u002FREADME.md)\n- 🪝 [Hooks Setup](.claude\u002Fhooks\u002FREADME.md)\n- 🤖 [Agents Guide](.claude\u002Fagents\u002FREADME.md)\n- 📝 [Dev Docs Pattern](dev\u002FREADME.md)\n\n**Start here:** Copy the two essential hooks, add one skill, and see the auto-activation magic happen.\n","# Claude Code 基础设施展示\n\n**经过生产环境验证的 Claude Code 基础设施精选参考库。**\n\n本展示源自于为期6个月的实际项目经验，涉及管理一个复杂的 TypeScript 微服务项目。它提供了能够解决“技能不会自动激活”问题，并使 Claude Code 能够扩展到企业级开发中的模式与系统。\n\n> **这并不是一个可运行的应用程序**——而是一个参考库。请将您需要的部分复制到您自己的项目中。\n\n---\n\n## 内容概览\n\n**适用于生产环境的基础设施包括：**\n- ✅ 通过钩子实现的**自动激活技能**\n- ✅ **模块化技能模式**（500行规则与渐进式披露）\n- ✅ 针对复杂任务的**专用代理**\n- ✅ 能够在上下文重置后依然有效的**开发文档系统**\n- ✅ 使用通用博客领域的**全面示例**\n\n**构建所需时间：** 6个月的迭代  \n**集成到您的项目所需时间：** 15–30分钟\n\n---\n\n## 快速入门——选择适合您的路径\n\n### 🤖 想使用 Claude Code 进行集成吗？\n\n**Claude：** 请阅读 [`CLAUDE_INTEGRATION_GUIDE.md`](CLAUDE_INTEGRATION_GUIDE.md)，获取专为 AI 辅助设置量身定制的分步集成指南。\n\n### 🎯 我想要技能自动激活功能\n\n**突破性功能：** 技能在您需要时真正激活。\n\n**您需要：**\n1. 技能激活钩子（2个文件）\n2. 一两个与您工作相关的技能\n3. 15分钟\n\n**👉 [设置指南：.claude\u002Fhooks\u002FREADME.md](.claude\u002Fhooks\u002FREADME.md)**\n\n### 📚 我想添加一个技能\n\n浏览 [技能目录](.claude\u002Fskills\u002F) 并复制您需要的内容。\n\n**可用技能：**\n- **backend-dev-guidelines** —— Node.js\u002FExpress\u002FTypeScript 模式\n- **frontend-dev-guidelines** —— React\u002FTypeScript\u002FMUI v7 模式\n- **skill-developer** —— 用于创建技能的元技能\n- **route-tester** —— 测试已认证的 API 路由\n- **error-tracking** —— Sentry 集成模式\n\n**👉 [技能指南：.claude\u002Fskills\u002FREADME.md](.claude\u002Fskills\u002FREADME.md)**\n\n### 🤖 我想要专用代理\n\n10种经过生产验证的代理，用于处理复杂任务：\n- 代码架构评审\n- 重构协助\n- 文档生成\n- 错误调试\n- 以及其他更多……\n\n**👉 [代理指南：.claude\u002Fagents\u002FREADME.md](.claude\u002Fagents\u002FREADME.md)**\n\n---\n\n## 与众不同之处？\n\n### 自动激活的突破\n\n**问题：** Claude Code 的技能只是静静地躺在那里，您必须记得去使用它们。\n\n**解决方案：** UserPromptSubmit 钩子能够：\n- 分析您的提示\n- 检查文件上下文\n- 自动建议相关技能\n- 通过 `skill-rules.json` 配置生效\n\n**结果：** 技能在您需要时自动激活，而不是在您想起时才激活。\n\n### 经过生产验证的模式\n\n这些并非理论上的示例，而是从以下内容中提炼出来的：\n- ✅ 6个处于生产状态的微服务\n- ✅ 超过5万行的 TypeScript 代码\n- ✅ 具有复杂数据网格的 React 前端\n- ✅ 精密的工作流引擎\n- ✅ 6个月的日常 Claude Code 使用\n\n这些模式之所以有效，是因为它们确实解决了实际问题。\n\n### 模块化技能（500行规则）\n\n大型技能容易超出上下文限制。解决方案如下：\n\n```\n技能名称\u002F\n  SKILL.md                  # \u003C500行，高层次指南\n  resources\u002F\n    topic-1.md              # 每个文件\u003C500行\n    topic-2.md\n    topic-3.md\n```\n\n**渐进式披露：** Claude 会先加载主技能文件，仅在需要时才会加载资源文件。\n\n---\n\n## 仓库结构\n\n```\n.claude\u002F\n├── skills\u002F                 # 5个生产级技能\n│   ├── backend-dev-guidelines\u002F  (12个资源文件)\n│   ├── frontend-dev-guidelines\u002F (11个资源文件)\n│   ├── skill-developer\u002F         (7个资源文件)\n│   ├── route-tester\u002F\n│   ├── error-tracking\u002F\n│   └── skill-rules.json    # 技能激活配置\n├── hooks\u002F                  # 6个自动化钩子\n│   ├── skill-activation-prompt.*  (至关重要)\n│   ├── post-tool-use-tracker.sh   (至关重要)\n│   ├── tsc-check.sh        (可选，需自定义)\n│   └── trigger-build-resolver.sh  (可选)\n├── agents\u002F                 # 10个专用代理\n│   ├── code-architecture-reviewer.md\n│   ├── refactor-planner.md\n│   ├── frontend-error-fixer.md\n│   └── ... 还有7个\n└── commands\u002F               # 3个斜杠命令\n    ├── dev-docs.md\n    └── ...\n\ndev\u002F\n└── active\u002F                 # 开发文档模式示例\n    └── public-infrastructure-repo\u002F\n```\n\n---\n\n## 组件目录\n\n### 🎨 技能（5个）\n\n| 技能 | 行数 | 目的 | 最佳适用场景 |\n|-------|-------|---------|----------|\n| [**skill-developer**](.claude\u002Fskills\u002Fskill-developer\u002F) | 426 | 创建和管理技能 | 元开发 |\n| [**backend-dev-guidelines**](.claude\u002Fskills\u002Fbackend-dev-guidelines\u002F) | 304 | Express\u002FPrisma\u002FSentry 模式 | 后端 API |\n| [**frontend-dev-guidelines**](.claude\u002Fskills\u002Ffrontend-dev-guidelines\u002F) | 398 | React\u002FMUI v7\u002FTypeScript | React 前端 |\n| [**route-tester**](.claude\u002Fskills\u002Froute-tester\u002F) | 389 | 测试已认证的路由 | API 测试 |\n| [**error-tracking**](.claude\u002Fskills\u002Ferror-tracking\u002F) | ~250 | Sentry 集成 | 错误监控 |\n\n**所有技能均遵循模块化模式**——主文件加上资源文件，实现渐进式披露。\n\n**👉 [如何集成技能 →](.claude\u002Fskills\u002FREADME.md)**\n\n### 🪝 钩子（6个）\n\n| 钩子 | 类型 | 是否必要 | 自定义需求 |\n|------|------|-----------|---------------|\n| skill-activation-prompt | UserPromptSubmit | ✅ 是 | ✅ 无需任何自定义 |\n| post-tool-use-tracker | PostToolUse | ✅ 是 | ✅ 无需任何自定义 |\n| tsc-check | Stop | ⚠️ 可选 | ⚠️ 需大量调整——仅限单体仓库 |\n| trigger-build-resolver | Stop | ⚠️ 可选 | ⚠️ 需大量调整——仅限单体仓库 |\n| error-handling-reminder | Stop | ⚠️ 可选 | ⚠️ 中等程度的自定义 |\n| stop-build-check-enhanced | Stop | ⚠️ 可选 | ⚠️ 中等程度的自定义 |\n\n**请从两个必要的钩子开始**——它们能够实现技能自动激活，并且开箱即用。\n\n**👉 [钩子设置指南 →](.claude\u002Fhooks\u002FREADME.md)**\n\n### 🤖 代理（10个）\n\n**独立使用——直接复制即可！**\n\n| 代理 | 目的 |\n|-------|---------|\n| code-architecture-reviewer | 审查代码以确保架构一致性 |\n| code-refactor-master | 规划并执行代码重构 |\n| documentation-architect | 生成全面的文档 |\n| frontend-error-fixer | 调试前端错误 |\n| plan-reviewer | 审核开发计划 |\n| refactor-planner | 制定代码重构策略 |\n| web-research-specialist | 在线研究技术问题 |\n| auth-route-tester | 测试已认证的端点 |\n| auth-route-debugger | 调试认证相关问题 |\n| auto-error-resolver | 自动修复 TypeScript 错误 |\n\n**👉 [代理如何工作 →](.claude\u002Fagents\u002FREADME.md)**\n\n### 💬 斜杠命令（3个）\n\n| 命令 | 目的 |\n|---------|---------|\n| \u002Fdev-docs | 创建结构化的开发文档 |\n| \u002Fdev-docs-update | 在上下文重置前更新文档 |\n| \u002Froute-research-for-testing | 为测试研究路由模式 |\n\n---\n\n## 核心概念\n\n### 挂钩 + skill-rules.json = 自动激活\n\n**系统：**\n1. **skill-activation-prompt 挂钩** 在每次用户提问时运行\n2. 检查 **skill-rules.json** 中的触发模式\n3. 自动建议相关技能\n4. 技能仅在需要时加载\n\n**这解决了 Claude Code 技能的首要问题**：它们无法自行激活。\n\n### 渐进式披露（500 行规则）\n\n**问题：** 大型技能会触及上下文限制。\n\n**解决方案：** 模块化结构\n- 主 SKILL.md 少于 500 行（概述 + 导航）\n- 资源文件每份少于 500 行（深入内容）\n- Claude 会根据需要逐步加载\n\n**示例：** backend-dev-guidelines 包含 12 个资源文件，分别涵盖路由、控制器、服务、仓库、测试等内容。\n\n### 开发文档模式\n\n**问题：** 上下文重置会导致项目背景丢失。\n\n**解决方案：** 三文件结构\n- `[task]-plan.md` - 战略计划\n- `[task]-context.md` - 关键决策和文件\n- `[task]-tasks.md` - 清单格式\n\n**适用场景：** 使用 `\u002Fdev-docs` 斜杠命令可自动生成这些文件。\n\n---\n\n## ⚠️ 重要提示：原样使用无效的内容\n\n### settings.json\n随附的 `settings.json` 仅为**示例**：\n- Stop 挂钩引用了特定的 monorepo 结构\n- 服务名称（如 blog-api 等）均为示例\n- MCP 服务器可能并不存在于您的环境中\n\n**使用方法：**\n1. 仅提取 UserPromptSubmit 和 PostToolUse 挂钩\n2. 自定义或跳过 Stop 挂钩\n3. 根据您的环境更新 MCP 服务器列表\n\n### 博客领域示例\n技能使用通用的博客示例（Post\u002FComment\u002FUser）：\n- 这些是**教学示例**，而非强制要求\n- 相关模式适用于任何领域（电商、SaaS 等）\n- 请根据您的业务逻辑调整这些模式\n\n### 挂钩目录结构\n部分挂钩假定特定的目录结构：\n- `tsc-check.sh` 假设存在服务目录\n- 请根据您的项目布局进行自定义\n\n---\n\n## 集成流程\n\n**推荐步骤：**\n\n### 第一阶段：技能激活（15 分钟）\n1. 复制 skill-activation-prompt 挂钩\n2. 复制 post-tool-use-tracker 挂钩\n3. 更新 settings.json\n4. 安装挂钩依赖项\n\n### 第二阶段：添加首个技能（10 分钟）\n1. 选择一个相关的技能\n2. 复制该技能目录\n3. 创建或更新 skill-rules.json\n4. 自定义路径模式\n\n### 第三阶段：测试与迭代（5 分钟）\n1. 编辑文件——技能应自动激活\n2. 提出问题——技能应被建议\n3. 根据需要添加更多技能\n\n### 第四阶段：可选增强\n- 添加您认为有用的代理\n- 添加斜杠命令\n- 自定义 Stop 挂钩（进阶操作）\n\n---\n\n## 获取帮助\n\n### 对于用户\n**集成遇到问题？**\n1. 查看 [CLAUDE_INTEGRATION_GUIDE.md](CLAUDE_INTEGRATION_GUIDE.md)\n2. 向 Claude 提问：“为什么 [技能] 没有激活？”\n3. 提交包含您项目结构的问题\n\n### 对于 Claude Code 团队\n在协助用户集成时：\n1. **务必先阅读 CLAUDE_INTEGRATION_GUIDE.md**\n2. 询问用户的项目结构\n3. 进行个性化调整，不要盲目照搬\n4. 验证集成效果\n\n---\n\n## 解决的问题\n\n### 在引入此基础设施之前\n\n❌ 技能无法自动激活\n❌ 必须记住使用哪个技能\n❌ 大型技能会超出上下文限制\n❌ 上下文重置会导致项目知识丢失\n❌ 开发过程中缺乏一致性\n❌ 每次都需要手动调用代理\n\n### 引入此基础设施之后\n\n✅ 技能可根据上下文自动建议\n✅ 挂钩会在恰当时机触发技能\n✅ 模块化技能始终控制在上下文限制内\n✅ 开发文档可在上下文重置后保留知识\n✅ 通过护栏实现一致的开发模式\n✅ 代理简化复杂任务\n\n---\n\n## 社区\n\n**觉得本内容有用吗？**\n\n- ⭐ 为本仓库点赞\n- 🐛 报告问题或提出改进建议\n- 💬 分享您自己的技能\u002F挂钩\u002F代理\n- 📝 贡献来自您所在领域的示例\n\n**背景：**\n这套基础设施曾在我的 Reddit 帖子中详细介绍：“Claude Code 是个猛兽——6 个月深度使用的心得”。在收到数百条请求后，我们创建了这个展示项目，旨在帮助社区落地这些模式。\n\n\n---\n\n## 许可证\n\nMIT 许可证——您可自由地将其用于商业或个人项目中。\n\n---\n\n## 快速链接\n\n- 📖 [Claude 集成指南](CLAUDE_INTEGRATION_GUIDE.md) - 用于 AI 辅助设置\n- 🎨 [技能文档](.claude\u002Fskills\u002FREADME.md)\n- 🪝 [挂钩设置](.claude\u002Fhooks\u002FREADME.md)\n- 🤖 [代理指南](.claude\u002Fagents\u002FREADME.md)\n- 📝 [开发文档模式](dev\u002FREADME.md)\n\n**从这里开始：** 复制两个核心挂钩，添加一项技能，即可体验自动激活的神奇效果。","# Claude Code Infrastructure Showcase 快速上手指南\n\n本指南旨在帮助开发者快速将经过生产验证的 Claude Code 基础设施集成到现有项目中，实现技能（Skills）的自动激活、模块化加载及专用智能体（Agents）调用。\n\n> **注意**：本项目是**参考库**而非可直接运行的应用程序。请根据指南将所需组件复制到您的项目中。\n\n## 环境准备\n\n在开始之前，请确保满足以下系统要求和前置依赖：\n\n*   **操作系统**: Linux, macOS 或 Windows (WSL2 推荐)\n*   **核心工具**:\n    *   [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) CLI 已安装并配置好 API Key。\n    *   Node.js (v18+) 及 npm\u002Fpnpm\u002Fyarn（用于运行部分 Shell 钩子脚本中的逻辑）。\n    *   Git (用于克隆参考库)。\n*   **项目结构**: 拥有一个正在开发的代码库（支持 TypeScript\u002FJavaScript 项目效果最佳，但模式通用）。\n*   **前置知识**: 熟悉 Claude Code 的基本概念，如 Skills, Hooks, Agents 和 Slash Commands。\n\n## 安装步骤\n\n建议分阶段集成，首先实现核心的“技能自动激活”功能。\n\n### 1. 获取参考代码\n克隆或下载本仓库到本地，以便查看源码结构：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fyour-org\u002Fclaude-code-infrastructure-showcase.git\ncd claude-code-infrastructure-showcase\n```\n\n### 2. 核心钩子（Hooks）集成\n这是实现技能自动激活的关键。只需复制两个核心文件到您的项目 `.claude\u002Fhooks\u002F` 目录。\n\n**步骤:**\n1.  在项目根目录创建 `.claude\u002Fhooks` 文件夹（如果不存在）。\n2.  从参考库复制以下两个文件：\n    *   `skill-activation-prompt.ts` (或 `.js`，取决于您的项目类型，参考库中通常为 TS)\n    *   `post-tool-use-tracker.sh`\n\n```bash\n# 假设您在项目根目录执行\nmkdir -p .claude\u002Fhooks\n\n# 复制核心钩子文件 (请根据实际下载路径调整源文件位置)\ncp ..\u002Fclaude-code-infrastructure-showcase\u002F.claude\u002Fhooks\u002Fskill-activation-prompt.* .claude\u002Fhooks\u002F\ncp ..\u002Fclaude-code-infrastructure-showcase\u002F.claude\u002Fhooks\u002Fpost-tool-use-tracker.sh .claude\u002Fhooks\u002F\n\n# 赋予执行权限\nchmod +x .claude\u002Fhooks\u002Fpost-tool-use-tracker.sh\n```\n\n3.  **配置 settings.json**:\n    编辑或创建项目根目录下的 `.claude\u002Fsettings.json`，注册上述钩子。确保只启用 `UserPromptSubmit` 和 `PostToolUse` 类型的钩子以开始使用。\n\n```json\n{\n  \"hooks\": {\n    \"UserPromptSubmit\": [\n      \".\u002F.claude\u002Fhooks\u002Fskill-activation-prompt.ts\"\n    ],\n    \"PostToolUse\": [\n      \".\u002F.claude\u002Fhooks\u002Fpost-tool-use-tracker.sh\"\n    ]\n  }\n}\n```\n*(注：参考库中的 `tsc-check.sh` 等 Stop 钩子针对特定单体仓库结构，初次集成建议跳过，避免报错)*\n\n### 3. 添加第一个技能 (Skill)\n为了让自动激活生效，您需要至少一个技能及其规则配置。\n\n**步骤:**\n1.  创建 `.claude\u002Fskills` 目录。\n2.  从参考库的 `.claude\u002Fskills\u002F` 中选择一个适合您项目的技能文件夹（例如 `backend-dev-guidelines` 或 `frontend-dev-guidelines`）并复制。\n3.  复制 `skill-rules.json` 配置文件到 `.claude\u002Fskills\u002F` 目录。\n\n```bash\nmkdir -p .claude\u002Fskills\n\n# 示例：复制后端开发指南技能\ncp -r ..\u002Fclaude-code-infrastructure-showcase\u002F.claude\u002Fskills\u002Fbackend-dev-guidelines .claude\u002Fskills\u002F\n\n# 复制规则配置文件\ncp ..\u002Fclaude-code-infrastructure-showcase\u002F.claude\u002Fskills\u002Fskill-rules.json .claude\u002Fskills\u002F\n```\n\n4.  **自定义规则**: 打开 `.claude\u002Fskills\u002Fskill-rules.json`，根据您项目的实际文件路径模式（glob patterns）调整触发条件，确保钩子能正确识别上下文。\n\n## 基本使用\n\n完成上述步骤后，无需额外命令即可体验自动化功能。\n\n### 1. 测试技能自动激活\n启动 Claude Code 并尝试进行与所选技能相关的操作。系统会根据您的提示词和当前文件上下文，自动建议加载相关技能。\n\n**示例场景**:\n假设您复制了 `backend-dev-guidelines` 技能，且规则配置为当检测到 `src\u002Fcontrollers` 目录下的文件时触发。\n\n```bash\nclaude\n```\n\n在对话中输入：\n```text\n帮我优化一下 src\u002Fcontrollers\u002FuserController.ts 中的错误处理逻辑。\n```\n\n**预期结果**:\nClaude Code 会自动检测到上下文匹配 `skill-rules.json` 中的规则，并在回复前自动加载 `backend-dev-guidelines` 技能及其相关资源文件，无需您手动输入 `\u002Fskill backend-dev-guidelines`。\n\n### 2. 使用专用智能体 (Agents)\n您可以直接调用参考库中预定义的专用智能体来处理复杂任务。\n\n**使用方法**:\n在对话中直接指定使用某个 Agent 文件（需先将 `.claude\u002Fagents\u002F` 下的 `.md` 文件复制到您的项目中）。\n\n```text\n@code-architecture-reviewer 请审查当前的项目架构一致性。\n```\n或者使用 Slash Command（如果已复制 `commands` 目录）：\n```text\n\u002Fdev-docs 生成当前任务的开发文档计划。\n```\n\n### 3. 验证模块化加载\n对于大型技能，系统采用“渐进式披露”策略。主文件 (`SKILL.md`) 会先加载，只有当您深入询问特定主题时，才会动态加载 `resources\u002F` 目录下的细分文档，从而节省 Context 窗口。\n\n**下一步建议**:\n*   浏览 `.claude\u002Fskills\u002FREADME.md` 了解更多可用技能。\n*   根据需要逐步添加 `agents` 和 `commands`。\n*   切勿直接照搬 `settings.json` 中的全部配置，仅保留与您项目结构匹配的钩子。","某全栈开发团队正在维护一个包含 6 个微服务和复杂 React 前端的 TypeScript 项目，日常需频繁处理 API 路由调试、架构审查及代码重构任务。\n\n### 没有 claude-code-infrastructure-showcase 时\n- **技能依赖人工记忆**：开发者必须时刻记得手动调用特定的后端规范或测试技能，一旦遗忘，AI 生成的代码往往不符合项目既定的 Express\u002FTypeScript 模式。\n- **上下文窗口迅速耗尽**：庞大的开发指南文档一次性全部加载，导致 AI 可用上下文被占满，无法深入分析当前具体的业务逻辑。\n- **重复性配置耗时**：每次开启新会话或切换任务时，都需要重新向 AI 交代项目背景、Sentry 集成方式等基础信息，效率低下。\n- **复杂任务缺乏专项支持**：面对代码架构审查或深层错误调试时，通用助手难以提供符合生产环境标准的专业建议，需人工反复纠正。\n\n### 使用 claude-code-infrastructure-showcase 后\n- **技能智能自动激活**：通过 UserPromptSubmit 钩子，当开发者提到\"API 测试”或“前端重构”时，系统自动匹配并激活 `route-tester` 或 `frontend-dev-guidelines` 技能，无需人工干预。\n- **模块化资源按需加载**：遵循\"500 行规则”，主技能文件仅保留核心指引，详细的资源文档仅在需要时动态加载，既节省了上下文空间又保证了深度。\n- **开发语境持久化**：内置的 Dev docs 系统和钩子机制让 AI 在上下文重置后仍能“记住”项目特有的工作流引擎和数据结构，实现无缝连续开发。\n- **专用代理解决难题**：直接调用预置的“代码架构审查”或“错误调试”代理，瞬间获得基于 5 万行生产代码经验提炼出的高质量优化方案。\n\nclaude-code-infrastructure-showcase 将原本依赖开发者记忆的碎片化最佳实践，转化为了自动运行、按需加载的企业级研发基础设施。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdiet103_claude-code-infrastructure-showcase_8d82b6f5.png","diet103",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fdiet103_ed9b53df.png","https:\u002F\u002Fgithub.com\u002Fdiet103",[81,85],{"name":82,"color":83,"percentage":84},"Shell","#89e051",60.1,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",39.9,9414,1204,"2026-04-05T23:32:18","MIT","未说明","不需要 GPU",{"notes":96,"python":93,"dependencies":97},"此工具并非独立运行的 AI 模型或应用程序，而是一套供 'Claude Code' CLI 工具使用的配置库（包含技能、钩子、代理等）。它没有特定的操作系统、GPU 或内存硬性要求，其运行环境取决于宿主项目及已安装的 Claude Code 环境。主要集成工作涉及复制配置文件和 Shell 脚本，并可能需要根据具体项目结构自定义部分钩子脚本。",[98,99,100],"Claude Code CLI","Node.js (项目基于 TypeScript)","Shell (用于运行 hooks)",[26,15,61],"2026-03-27T02:49:30.150509","2026-04-06T14:03:49.143088",[],[]]