telecom-ops-claude-code-plugins

Telecom Ops Claude Code Plugin 提供了一組用於電信營運場景的指令與培訓代理，讓 Claude Code 能以插件方式與 O-RAN/Nephio 生態互動。核心功能包含 Slash Commands、智能代理（intent-translator）以及 Hook 的自動化流程，並提供一個 MCP Server 的 stub 配置，讓你在本地或開發環境先行驗證整合。使用者可以透過 /telecom-ops:intent-parse 將自然語言的服務意圖轉換成 Nephio/KRM 相容的配置包，並輸出 QoSIntent.yaml、NetworkSlice.yaml 等模板檔案。此外，/telecom-ops:o2-status 指令可查詢 O2-IMS 的站點健康與資源狀態。代理 intent-translator 能自動提取關鍵參數並產生 KRM 清單與 GitOps 敷設建議。Hook 配置 PostToolUse 讓每次工具調用後觸發自動渲染或驗證流程，增強整體自動化能力。當 MCP Server 整合成熟時，工具將提供 mcp__ 前綴的進階指令以操作實際的 O2-IMS MCP Server 資源。

Prerequisites:

• 一個 Claude Code 環境，支援安裝插件與 Marketplace。
• Git 與基本開發工具。
• (開發/測試用) Node.js 或 Python 環境取決於你要模擬的伺服端。

方法 1：從 GitHub 安裝（推薦）

# 在 Claude Code 中執行
/plugin marketplace add thc1006/telecom-ops-claude-code-plugins
/plugin install telecom-ops@telecom-ops-marketplace

方法 2：本地安裝（開發用）

# 克隆專案
git clone https://github.com/thc1006/telecom-ops-claude-code-plugins.git
cd telecom-ops-claude-code-plugins

# 在 Claude Code 中執行
/plugin marketplace add ./telecom-ops-tests/dev-marketplace
/plugin install telecom-ops@dev-marketplace

啟用插件:

/plugin enable telecom-ops

驗證安裝:

# 重啟 Claude Code 後
/plugin list

應該會看到 telecom-ops 插件已啟用。

測試案例與自動化測試可使用專案內的測試腳本。

Tips and 常見注意事項:

• MCP Server 配置：目前提供的是 Stub 配置範例。若要連接實際的 O2-IMS MCP Server，請實作符合 MCP 協議的 server，更新 telecom-ops/.mcp.json，並設定實際 API endpoint 與認證資訊。
• 環境變數：CLAUDE_PLUGIN_ROOT 變數用於腳本路徑定位，請在實際使用時確保環境變數正確設定。可在 mcpConfig 的 env 欄位加入所需的端點與認證。
• Hook 擴充：hooks.json 支援 PreToolUse、PostToolUse 與 Notification。範例中 PostToolUse 會呼叫 kpt-render.sh；你可以依需求新增其它 hook。語法與 matcher 可以參考 README 中的說明。
• 產出為骨架模板：intent parse 產生的 QoSIntent.yaml、NetworkSlice.yaml 等檔案是起始模板，需依實際環境調整參數與資源配額，建議先用 kpt render 驗證檔案正確性。
• MCP 與工具前綴：完成整合後，將可使用 mcp__ 前綴的工具來直接操作 MCP Server 端點與資源。
• 測試與自動化：telecom-ops-tests 提供 headless 測試與輸出，執行 bash telecom-ops-tests/scripts/run_headless.sh 可在 telecom-ops-tests/runs/ 目錄中取得結果。