---

name: "performance-analyst" description: "Activates when user requests performance optimization, N+1 query analysis, caching strategy design, database tuning, or scalability assessment. Do NOT use for security audits. Examples: 'Optimize this slow query', 'Check for N+1 problems'."

Performance Analyst Skill

🧠 Expertise

資深效能工程師，專精於資料庫優化、快取策略、系統擴展性設計，擁有大規模系統調優經驗。

---

1. 資料庫效能分析

1.1 N+1 查詢問題

定義：在迴圈中執行個別查詢，導致 1 + N 次資料庫請求。

識別模式：

Copy// ❌ N+1 Problem
$users = User::all();
foreach ($users as $user) {
    echo $user->profile->name;  // 每次迭代執行一次查詢
}

// ✅ Eager Loading 解決方案
$users = User::with('profile')->get();
foreach ($users as $user) {
    echo $user->profile->name;  // 無額外查詢
}

檢測工具：

• Laravel Debugbar
• DB::enableQueryLog() + DB::getQueryLog()
• Clockwork

---

1.2 索引優化

需要索引的欄位：

紅旗標誌：

• ❌ 大表無主鍵/索引的 WHERE 條件
• ❌ LIKE '%keyword%' 查詢
• ❌ 函數包裹索引欄位：WHERE YEAR(created_at) = 2024

索引建議：

Copy-- 複合索引順序：選擇性高的欄位在前
CREATE INDEX idx_orders_status_date ON orders(status, created_at);

-- 覆蓋索引：包含所有需要的欄位
CREATE INDEX idx_users_email_name ON users(email, name);

---

1.3 查詢優化

選取欄位最小化：

Copy// ❌ 選取所有欄位
User::all();

// ✅ 只選需要的欄位
User::select('id', 'name', 'email')->get();

分頁處理：

Copy// ❌ 載入全部資料
$users = User::all();

// ✅ 分頁查詢
$users = User::paginate(20);

// ✅ Cursor 分頁（大資料集）
$users = User::cursor();

批次處理：

Copy// ❌ 記憶體爆炸
$users = User::all();
foreach ($users as $user) { /* 處理 */ }

// ✅ Chunk 分批處理
User::chunk(1000, function ($users) {
    foreach ($users as $user) { /* 處理 */ }
});

// ✅ Lazy Collection（更省記憶體）
User::lazy()->each(function ($user) { /* 處理 */ });

---

2. 時間/空間複雜度分析

2.1 時間複雜度

紅旗標誌：

• ❌ 隱藏的 O(n²) 巢狀迴圈
• ❌ 遞迴無 memoization
• ❌ 迴圈內執行 IO 操作

---

2.2 空間複雜度

記憶體風險：

Copy// ❌ 高記憶體使用
$allData = DB::table('big_table')->get();  // 全部載入記憶體

// ✅ 串流處理
DB::table('big_table')->cursor()->each(function ($row) {
    // 逐筆處理
});

記憶體洩漏風險：

• 迴圈內累積陣列
• 未釋放的資源（檔案Handle、Connection）
• 靜態變數累積

---

3. 快取策略

3.1 快取層級

---

3.2 快取 Key 設計

命名規範：

Copy{prefix}:{entity}:{identifier}:{version}

範例：

Copy// ✅ Good
"user_profile:123:v1"
"game_list:platform_1:active:v2"

// ❌ Bad
"user-profile-123"      // 不一致的分隔符
"userProfile:123"       // 命名風格不一致
"data:123"              // 缺乏語意

---

3.3 快取失效策略

Laravel 快取範例：

Copy// Cache Aside 模式
$user = Cache::remember("user:{$id}", 3600, function () use ($id) {
    return User::find($id);
});

// 主動失效
public function updateUser($id, $data): User
{
    $user = User::findOrFail($id);
    $user->update($data);
    Cache::forget("user:{$id}");
    return $user;
}

---

4. 擴展性評估

4.1 水平擴展檢查

紅旗標誌：

• ❌ 本地檔案 Session
• ❌ 本地檔案儲存
• ❌ 記憶體內快取（單機）
• ❌ 同步處理耗時任務

---

4.2 負載壓力點識別

---

4.3 瓶頸識別

常見瓶頸：

1. 資料庫連接數 - 使用連接池
2. 慢查詢 - 優化索引、快取
3. 同步 IO - 改為非同步/佇列
4. 單點故障 - 高可用架構

監控指標：

---

5. 效能審查評分標準