claude-code-infrastructure-showcase

用途

claude-code-infrastructure-showcase 是一个参考库（reference library），而非可运行的应用程序。它的目标是为开发者提供一套经过生产验证的 Claude Code 基础设施实现模式，用于搭建自动激活技能、钩子、专用智能体与开发文档系统。资料强调，这些模式提取自 6 个月的 TypeScript 微服务真实开发实践。

核心理念是：复制你需要的部分到自己的项目中，所有内容都被设计为可抽取和可定制。

主要能力

自动激活系统

资料指出一个常见问题：技能不会自动激活，需要使用者主动想起去使用它们。该项目的解决方案是钩子加配置系统：

skill-activation-prompt 钩子在每次用户提交提示时运行
分析提示文本和已打开的文件路径
与 skill-rules.json 中的模式进行匹配
自动推荐相关技能

技能的激活规则通过 skill-rules.json 配置，包含 pathPatterns（路径模式）与 promptKeywords（提示关键词），并设置 autoActivate。例如 backend-dev-guidelines 技能可配置路径模式 **/src/routes/**、**/src/controllers/**、**/src/services/** 与关键词 "api"、"endpoint"、"route"、"controller"、"service"、"repository"、"database"。

模块化技能（500 行规则）

资料说明大型技能会触及上下文限制，因此采用渐进式披露（progressive disclosure）方式：

skill-name/
├── SKILL.md                    # <500 lines - overview + navigation
└── resources/
    ├── routing-patterns.md     # <500 lines each
    ├── testing-guide.md
    └── error-handling.md

SKILL.md 作为入口点，包含概览与快速导航；资源文件在需要时按需加载。

开发文档模式

用于在 Claude Code 重置之间保留上下文，结构如下：

dev/active/[task-name]/
├── [task]-plan.md       # Strategic overview
├── [task]-context.md    # Key decisions & files
└── [task]-tasks.md      # Checklist format

也可通过斜杠命令 /dev-docs "任务描述" 创建。

仓库结构

.claude/
├── skills/                          # Production skills
│   ├── backend-dev-guidelines/      # Node.js/Express/Prisma patterns
│   ├── frontend-dev-guidelines/     # React/TypeScript/MUI v7
│   ├── skill-developer/             # Meta-skill for creating skills
│   ├── route-tester/                # API route testing
│   ├── error-tracking/              # Sentry integration
│   └── skill-rules.json            # Skill activation config
├── hooks/                           # Automation hooks
│   ├── skill-activation-prompt.*    # Auto-suggest skills (ESSENTIAL)
│   ├── post-tool-use-tracker.sh     # Track file operations (ESSENTIAL)
│   ├── tsc-check.sh                 # TypeScript validation (optional)
│   └── trigger-build-resolver.sh    # Build error resolution (optional)
├── agents/                          # Specialized agents
│   ├── code-architecture-reviewer.md
│   ├── refactor-planner.md
│   └── ... 8 more agents
└── commands/                        # Slash commands
    └── dev-docs.md

dev/active/                          # Dev docs examples

使用方式

第一阶段：配置必要钩子（约 15 分钟）

复制钩子文件并赋予执行权限：

cp .claude/hooks/skill-activation-prompt.* your-project/.claude/hooks/
cp .claude/hooks/post-tool-use-tracker.sh your-project/.claude/hooks/
chmod +x your-project/.claude/hooks/*.sh

安装 Node.js 依赖（供 skill-activation-prompt 使用）：

cd your-project/.claude/hooks
npm init -y
npm install fs path

更新 settings.json：

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "command": "node",
        "args": [".claude/hooks/skill-activation-prompt.js"],
        "timeout": 5000
      }
    ],
    "PostToolUse": [
      {
        "command": ".claude/hooks/post-tool-use-tracker.sh",
        "timeout": 3000
      }
    ]
  }
}

第二阶段：添加第一个技能（约 10 分钟）

可选技能包括：backend-dev-guidelines（Express/Prisma/TypeScript API）、frontend-dev-guidelines（React/MUI/TypeScript）、skill-developer（创建新技能）、route-tester（测试已认证路由）、error-tracking（Sentry 集成）。

复制技能目录并创建/更新 skill-rules.json，然后根据自己项目结构调整路径模式：

cp -r .claude/skills/backend-dev-guidelines your-project/.claude/skills/
cp .claude/skills/skill-rules.json your-project/.claude/skills/

第三阶段：测试激活（约 5 分钟）

路径激活测试：打开匹配 pathPatterns 的文件并向 Claude 提问
关键词激活测试：使用触发关键词提问

可用智能体

资料列出多个专用智能体，通过 @ 引用使用，例如：

@code-architecture-reviewer Review the new user service for architectural issues
@refactor-planner Plan refactoring of the auth system to use dependency injection
@frontend-error-fixer Fix the "Cannot read property 'map' of undefined" error in UserList
@documentation-architect Generate API documentation for the user service
@auth-route-tester Test POST /api/users/register with sample data
@auto-error-resolver Fix type errors in src/services/userService.ts

适用场景

使用 Claude Code 进行 TypeScript 微服务开发，尤其是 Node.js/Express/Prisma 后端与 React/MUI 前端
希望让技能根据文件路径或提示关键词自动激活的团队
需要为复杂开发任务（架构评审、重构规划、错误修复、文档生成、路由测试）配置专用智能体的项目
需要在会话重置之间保留开发任务上下文的长期开发工作

限制

该项目是参考库，不是可直接运行的应用程序；需要手动复制并定制到自己的项目中。
官方文本（official_text）为空，因此价格、收费、平台支持范围、实际效果等信息暂未提供。
自动激活依赖钩子与 settings.json 配置，需按自身项目结构调整路径模式与关键词。