Claude 系统架构全解析

收集上下文 → 执行操作 → 验证工作 → 重复

Enterprise (最低)
    ↓
User (~/.claude/CLAUDE.md)
    ↓
Project (./CLAUDE.md)
    ↓
Module (./src/module/CLAUDE.md) (最高)

my-plugin/
├── .claude-plugin/
│   └── plugin.json     # 插件清单（必需）
├── commands/           # Slash Commands
├── agents/             # Subagents
├── skills/             # Skills
├── hooks/              # Hooks 配置
├── .mcp.json           # MCP Server 配置
└── README.md           # 说明文档

// plugin.json
{
  "name": "frontend-toolkit",
  "version": "1.0.0",
  "description": "前端开发工具包",
  "author": "Your Team"
}

# 安装方式
claude plugin install github:your-org/your-plugin  # 从 GitHub
claude plugin install /path/to/plugin              # 从本地

┌─────────────────┐
│   MCP Host      │  (Claude Desktop, IDE, AI 工具)
│   (Main Agent)  │
└────────┬────────┘
         │ 1:N
    ┌────┴────┬────────┬────────┐
    │ Client  │ Client │ Client │  (协议客户端)
    └────┬────┴────┬───┴────┬───┘
         │         │        │
    ┌────┴────┐ ┌──┴───┐ ┌─┴────┐
    │ Server  │ │Server│ │Server│  (暴露特定能力)
    │ GitHub  │ │  DB  │ │ Slack│
    └─────────┘ └──────┘ └──────┘

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

请对当前变更进行代码审查，重点关注：
1. 代码风格和一致性
2. 潜在的性能问题
3. 安全漏洞
4. 测试覆盖率

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read f; [[ $f == *.ts ]] && npx prettier --write \"$f\"; }"
          }
        ]
      }
    ]
  }
}

/ralph-loop "实现 TODO API，包含 CRUD 和测试" --max-iterations 20

Main Agent (Orchestrator)
    ├── 分析用户请求
    ├── 制定计划
    ├── 分解任务
    └── 生成专门化子代理
         ↓
    ┌────────┬────────┬────────┐
    │ Sub 1  │ Sub 2  │ Sub 3  │  (Workers - 并行执行)
    │ 代码   │ 测试   │ 文档   │
    └────────┴────────┴────────┘
         ↓
    汇总结果 → 主代理综合输出

---
name: Code Reviewer
description: 专门进行代码审查的子代理
tools:
  - Read
  - Grep
  - Glob
---

你是一位资深代码审查专家。请重点关注：
1. 代码质量和可维护性
2. 潜在的 Bug 和边界情况
3. 性能优化机会
4. 安全漏洞

📚 Skills 工作手册
│
├─ 📋 目录 ────────────── 【元数据层】启动时预加载 (~30-50 tokens)
│   name: "weekly-report"
│   description: "生成标准化周报"
│
├─ 📖 正文章节 ─────────── 【核心文档层】相关时加载 (~数百-数千 tokens)
│   # Weekly Report Generator
│   ## Instructions
│   按以下结构生成周报...
│
└─ 📎 附录 ────────────── 【引用资源层】需要时加载
    references/
    ├── template.xlsx
    └── examples/

my-skill/
├── SKILL.md          # 核心指令（必需）
├── scripts/          # 可执行脚本（可选）
└── references/       # 参考资料（可选）

---
name: code-review                        # Skill 名称
description: 代码审查，检查质量和安全性    # 简短描述（用于自动匹配）
---

# Code Review Skill

## Instructions
[具体的步骤说明...]

## Output Format
[输出格式要求...]