# RCA_<服務名稱>_<問題簡述>_<日期>.md

<!-- 
AI AGENT METADATA (YAML Frontmatter)
AI Agent 應優先讀取此區塊的結構化數據
-->
---
document_type: "rca"
service: "<服務名稱>"
problem: "<問題簡述>"
date: "<YYYY-MM-DD>"
severity: "P0"  # P0/P1/P2/P3/P4
status: "active"  # active/completed/archived
current_state: "investigating"  # pending/investigating/resolving/resolved/closed
owner: "<負責人姓名>"
created_by: "<創建者姓名>"
created_at: "<YYYY-MM-DD HH:MM>"
version: "1.0"
tags:
- "incident"
- "<服務標籤>"
- "<問題類型>"
related_documents:
- "INCIDENT_<相關事件>.md"
- "CHANGE_<相關變更>.md"
ai_query_hints:
- "如何查詢所有 P0 級別的 RCA？"
- "如何找到與 n8n 相關的所有 RCA？"
- "如何更新 RCA 狀態？"
---

<!-- 
HUMAN READABLE SECTION (Markdown Tables)
人類可讀的表格部分，AI Agent 也可解析但優先使用上述 YAML
-->
| 項目 | 內容 |
|------|------|
| **文件類型** | 根本原因分析 (RCA) |
| **相關服務** | <服務列表> |
| **嚴重等級** | P0/P1/P2/P3/P4 |
| **當前狀態** | ⏳ 待處理 / 🔍 調查中 / 🔧 處理中 / ✅ 已解決 / 📁 已關閉 |
| **創建日期** | YYYY-MM-DD |
| **完成日期** | YYYY-MM-DD |
| **負責人** | <姓名> |
| **文件版本** | V1.0 |

---

## 版本歷史

| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
|------|------|------|--------|-----------|
| V1.0 | (日期) | 創建文件 | (姓名) | (工具) |

---

## AI Agent 操作指南

### 快速查詢示例

```yaml
# 查詢所有 P0/P1 級別的 RCA
查找: document_type: "rca" AND (severity: "P0" OR severity: "P1")

# 查詢特定服務的活躍 RCA
查找: document_type: "rca" AND service: "n8n" AND status: "active"

# 查詢需要審核的 RCA
查找: document_type: "rca" AND current_state: "resolved" AND status: "active"
```

### 自動化操作

1. **狀態更新**：當 RCA 完成時，更新 `current_state` 和 `status`
2. **目錄移動**：根據狀態自動移動文件到相應目錄 (`_active/`, `_completed/`, `_archived/`)
3. **通知觸發**：根據嚴重等級自動發送通知

### 數據提取

```python
# Python 示例：提取 RCA 元數據
import yaml
import re

def extract_rca_metadata(file_path):
    with open(file_path, 'r') as f:
        content = f.read()
    
    # 提取 YAML frontmatter
    yaml_match = re.search(r'^---\n(.*?)\n---\n', content, re.DOTALL)
    if yaml_match:
        metadata = yaml.safe_load(yaml_match.group(1))
        return metadata
    
    # 備用：解析 Markdown 表格
    # ... 表格解析邏輯
```

---

## 概述

(簡要描述問題和影響範圍)

---

## 事件摘要

### 基本資訊

| 項目 | 內容 |
|------|------|
| **事件標題** | (簡短描述事件) |
| **影響服務** | (受影響的服務列表) |
| **嚴重等級** | P0/P1/P2/P3/P4 |
| **發現時間** | (YYYY-MM-DD HH:MM) |
| **解決時間** | (YYYY-MM-DD HH:MM) |
| **影響範圍** | (受影響的用戶、功能、數據等) |
| **停機時間** | (總停機時間) |

### 時間線摘要

| 時間 | 事件 | 操作 |
|------|------|------|
| (時間) | (事件描述) | (採取的操作) |

---

## 調查過程

<!-- 標準調查過程內容 -->

---

## AI Agent 備註

**最後更新**: 2026-03-27  
**AI 優化版本**: V1.0  
**兼容性**: 向後兼容現有模板

**注意**: 
- AI Agent 應優先讀取 YAML frontmatter 獲取結構化數據
- 人類用戶可閱讀 Markdown 表格部分
- 兩部分數據應保持同步
