Cloud Monitor：數字員工 Skill 格式規範

目錄說明

references 目錄

references/ 目錄用於存放技能執行時需要參考的文檔資料。數字員工會根據 SKILL.md 中的指令按需載入這些文檔。

適用情境：

• 發布檢查清單和變更操作規範。

• 故障處理手冊（Runbook）。

• 警示響應流程和升級鏈路。

• CI/CD 流水線配置說明。

• 服務依賴關係和 SLO 定義。

樣本結構：

references/
├── release-checklist.md     # 發布前檢查清單
├── rollback-runbook.md      # 復原操作手冊
└── alert-handling.md        # 警示處理規範

在 SKILL.md 中引用：

## 執行步驟
1. 參考 `references/release-checklist.md` 執行發布前檢查
2. 根據 `references/rollback-runbook.md` 評估是否需要復原

assets 目錄

assets/ 目錄用於存放模板檔案和靜態資源。這些資源可以作為輸出格式的參考，或作為產生內容的基礎模板。

適用情境：

• 故障複盤報告模板。

• 發布通知和變更記錄模板。

• CI/CD 流水線配置模板。

• 監控警示規則模板。

樣本結構：

assets/
├── incident-report.md       # 故障複盤報告模板
├── deploy-summary.md        # 發布通知模板
└── pipeline-config.yaml     # CI/CD 流水線配置模板

在 SKILL.md 中引用：

## 輸出格式
按照 `assets/incident-report.md` 模板格式輸出故障複盤報告。

## 發布通知
使用 `assets/deploy-summary.md` 作為發布完成通知的內容結構。

scripts 目錄

scripts/ 目錄用於存放可執行指令碼。數字員工可以調用這些指令碼來完成自動化任務，如代碼檢查、資料處理、檔案轉換等。

說明： 當前數字員工 Skill 不支援指令碼運行，此目錄僅供未來擴充使用。

適用情境：

• 服務健全狀態檢查指令碼。

• 日誌採集和分析指令碼。

• CI/CD 流水線觸發和狀態查詢指令碼。

• 基礎設施巡檢指令碼。

樣本結構：

scripts/
├── health-check.sh          # 服務健全狀態檢查指令碼
├── log-analyzer.py          # 日誌分析指令碼
└── pipeline-trigger.sh      # CI/CD 流水線觸發指令碼

指令碼編寫規範：

• 指令碼應支援命令列參數輸入。

• 輸出結果應為結構化文本，便於數字員工解析。

• 包含必要的錯誤處理和使用說明。

• 首行添加 shebang（如 #!/bin/bash 或 #!/usr/bin/env python3）。

中繼資料欄位

完整樣本

---
name: release-readiness-checker
description: 用於服務發布前的就緒檢查，評估健康狀態、流量、依賴服務是否具備發布條件
---

# Release Readiness Checker

## 概述
在服務發布前，自動檢查關鍵計量是否滿足發布條件，輸出發布就緒報告，降低發布風險。

## 執行步驟
1. 查詢目標服務當前的錯誤率、延遲、QPS 基準
2. 檢查依賴服務（資料庫、緩衝、下遊介面）的健康狀態
3. 確認 CI/CD 流水線最新構建是否通過（單測、整合測試）
4. 評估當前流量水位，判斷是否處於業務高峰期
5. 輸出發布就緒報告，標註風險項

## 輸出格式
輸出結構化的發布就緒報告，包含：
- 整體就緒結論（✅ 可發布 / ⚠️ 謹慎發布 / ❌ 不建議發布）
- 各檢查項的狀態和詳情
- 風險項說明和建議操作

## 注意事項
- 如無法擷取某項指標，標註為"資料缺失"並跳過，不影響其他項檢查
- 高峰期（工作日 10:00-12:00、14:00-18:00）發布需額外確認