# Nephio-O-RAN Claude Code Agents

## 打造電信自動化的專屬 AI 助理套件

> 這是一個為 **Nephio** 與 **O-RAN** 生態系量身打造的 Claude Code Sub-Agent 集合，讓你在開發、部署、監控到優化的每一個環節，都能呼叫「懂電信」的 AI 幫手。

> 專案網址：https://github.com/thc1006/nephio-oran-claude-agents

## 為何值得關注

* **一次到位的全流程支援**：從 O-Cloud 建置、CNF / xApp 管理，到安全與效能調校，9 個子代理人各司其職，涵蓋基礎建設到網路智慧分析。
* **零額外依賴**：所有代理人 **只使用 Claude Code 內建工具**（Read / Write / Bash / Search / Git），安裝即用，無需再裝 kubectl、Terraform… 等指令。
* **成本導向模型選擇**：依任務複雜度自動選用 haiku／sonnet／opus，兼顧速度與費用。
* **符合 O-RAN WG11 安全規範**：內建零信任與合規檢查流程。

## Agent一覽

| 分層 | 代理人檔名 | Claude 模型 | 主要職責 |
| ------------- | -------------------------------- | --------- | ------------------------- |
| 基礎建設 | `nephio-infrastructure-agent` | haiku | O-Cloud 佈署、K8s 生命週期管理 |
| 配置管理 | `configuration-management-agent` | sonnet | YANG / IaC / GitOps 與飄移偵測 |
| 網路功能 | `oran-network-functions-agent` | sonnet | CNF / xApp / RIC 操作 |
| 網路協調 | `nephio-oran-orchestrator-agent` | opus | 跨域服務編排、自動化工作流 |
| 監控分析 | `monitoring-analytics-agent` | sonnet | 指標收集、NWDAF、預測維運 |
| 數據分析 | `data-analytics-agent` | haiku | KPI 計算、ML Pipeline |
| 安全合規 | `security-compliance-agent` | opus | WG11 檢核、零信任策略 |
| 效能優化 | `performance-optimization-agent` | opus | AI-driven 調優、QoS 提升 |
| 相依診斷 | `oran-nephio-dep-doctor` | sonnet | 編譯 / 執行期相依問題修復 |
| | | | |

## 兩分鐘快速起步

# 1. 下載專案
git clone https://github.com/thc1006/nephio-oran-claude-agents.git
cd nephio-oran-claude-agents

# 2. 全域安裝（推薦）
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/

# 3. 驗證
claude code
# 輸入 /agents 應能看到 9 位助理

> **版本要求**：Claude Code ≥ v1.0.60。

---

## 典型用法

### 1. 自動選擇最適代理人

claude code "Provision a new Nephio cluster for edge deployment"

→ 會自動呼叫 `nephio-infrastructure-agent`。

### 2. 明確指定代理人

claude code "Use security-compliance-agent to audit our zero-trust setup"

### 3. 多代理協同工作流

claude code "
  1) Use configuration-management-agent to validate YANG models;
  2) Deploy CNFs via oran-network-functions-agent;
  3) Set up observability with monitoring-analytics-agent
"

## 專案結構一眼看懂

nephio-oran-claude-agents/
├─ agents/             # 9 個代理人檔案
├─ docs/               # 詳細說明與整合指南
├─ examples/           # 實戰用例與工作流
├─ tests/              # 驗證腳本與情境測試
└─ .github/workflows/  # CI 檢查 YAML

## 結語

如果你正研究 **Nephio 自動化**、**O-RAN 網路功能**，或者想在 **Claude Code** 中引入深度電信領域知識，這份代理人套件將是加速研發的最佳助攻。立即 clone 並體驗，讓 AI 助理替你處理繁瑣細節，把時間留給創新！