k8s-yaml-generator

k8s-yaml-generator 是一款專為 DevOps 工程師和平台運維人員設計的精密工具，旨在無需犧牲穩定性的前提下快速建構基礎設施即代碼 (IaC) 產物。該技能超越了簡單的模板創建，提供了一種決定性的工作流，包括運行前檢查、受限的 CRD 查詢以及強制性的驗證階段。無論您是要生成帶有持久卷聲明 (PVC) 的複雜 StatefulSet、配置 Ingress 控制器，還是為如 Argo CD 等 GitOps 工具建構自定義資源定義 (CRD)，該代理程式都能確保您的資訊清單符合現代 Kubernetes 的最佳實踐。

• 生成各類資源類型，包括 Deployment、Service、ConfigMap、Ingress、RBAC 以及複雜的 CRD。

• 採用決定性的執行模型，包含預檢、輸入擷取、CRD 解析、生成及驗證等固定步驟。

• 嚴格執行品質標準，如標籤一致性 (app.kubernetes.io/*)、資源限制與需求、就緒/存活探針 (probes) 以及 securityContext 安全設置。

• 提供受限的 CRD 查詢工作流，利用特定的工具文件解析功能，避免無限循環並確保準確性。

• 執行強制性的生成後驗證，透過 k8s-yaml-validator、kubeconform 及伺服器端 Dry-run 檢查，在部署前發現語法或 Schema 錯誤。

• 提供詳細的驗證報告，包含語法結果、Schema 合規性以及 Dry-run 狀態，以維持基礎設施創建流程的可觀察性。

• 用戶需提供明確的資源類型意圖、Pod 容器映像檔及命名空間要求，以便開始生成。

• 該技能採用安全第一的方法；若工具特定的驗證失敗，會提供文檔記錄的備援路徑或明確報告阻塞問題。

• 如有可能，請定義目標 Kubernetes 版本，以確保生成的 YAML 使用當前非棄用的 API 組與版本。

• 處理 CRD 時，若已知 API 版本與組別，請提供這些資訊，或允許代理程式使用其配置的 Context7 工具鏈進行有限搜尋。

• 此技能嚴格用於生成與編排；若僅需驗證任務，請使用獨立的 k8s-yaml-validator 技能，以避免冗餘的處理開銷。