dependency-analysis

dependency-analysis 技能是專為 Kubernetes 平台工程師與控制平面開發者設計的工具，旨在審核與驗證複雜的 Operator 互動。透過系統性掃描 controller-runtime 代碼，此技能可提取關鍵的觸發拓樸與 API 互動序列，包含讀取、寫入以及複雜的多寫入調用鏈。它作為原始代碼與 Kamera v2 模擬引擎之間的自動化橋樑，確保所有分析過的控制平面行為均符合嚴格的架構契約。

此技能適用於建構、維護或測試自定義 Kubernetes Operator 的開發人員。在安全性審計、可靠性審查，或準備將控制器用於故障注入測試時，此工具極具價值。使用者提供儲存庫訪問權限，代理會深入檢查入口點、Reconciler 連接與 API 調用站點，從而生成高精度的依賴工件。

• 透過 SetupWithManager、Watches 與 Owns 模式自動發現控制器註冊。

• 詳細提取觸發事件，區分主要、次要與手動控制器觸發器。

• 映射跨越 Reconcile 輔助調用鏈的 API 表面互動 (spec、status、metadata)。

• 識別多寫入序列中的崩潰漏洞窗口，捕捉如通道通訊等內存中的副作用。

• 基於對 API 文件、範例與快速入門的綜合分析，進行啟發式的資源角色分配 (user-facing、supporting 或 builtin)。

• 技能要求嚴格遵守專案的 dependency-graph-contract.md；若驗證腳本失敗，輸出將被拒絕。

• 用於為 Kamera 的離線追蹤模擬與控制平面驗證生成輸入。

• 務必包含 analysis-notes.md 作為所有角色分配決策的依據，特別是在通過外部文檔解決模糊性時。

• 此工具不會修改代碼；僅用於驗證與研究目的的觀察與工件生成工具。

• 需要本地 Shell 權限以執行針對生成工件的驗證腳本。