architecture-status

architecture-status 技能作為 AI 軟體架構框架的自動化健康檢查工具。它會掃描 .architecture/ 目錄以評估架構決策記錄 (ADR)、同儕與專家審查、重新校準進度以及團隊組成的狀態。此技能專為工程團隊與技術負責人設計，提供專案文件品質的集中概覽，有助於在軟體開發生命週期中維持架構嚴謹性。

• 對 ADR 檔案進行全面審計，計算採納、棄用與提案狀態。

• 總結架構審查活動，區分功能、版本與專家審查類型。

• 追蹤重新校準計畫，監控架構審查如何轉化為實作任務。

• 分析文件覆蓋範圍，找出安全性、基礎架構與系統設計等領域的缺口。

• 產生結構化的 Markdown 報告，包含關鍵指標摘要、近期活動記錄以及基於文件健康指標的具體行動建議。

• 根據現有缺口為使用者提供智慧指引，例如是否應建立新 ADR、啟動審查或諮詢專家。

• 透過掃描本地 .architecture/ 目錄運作；需要先初始化 AI Software Architect 框架。

• 根據文件更新頻率與近期活動，提供從「極佳」到「未啟用」的健康評級。

• 最適合在衝刺 (Sprint) 開始、重大發布前或專案轉換期間使用，以確保架構一致性。

• 若未偵測到框架，系統會提示使用者執行設定指令，如 'Setup ai-software-architect'。

• 與 Claude Code、Cursor 與 GitHub Copilot 等 AI 編碼助手無縫整合，維持架構演進的單一事實來源。

• 輸入為 .architecture/ 目錄中的現有檔案狀態；輸出為適用於團隊更新或儲存庫文件的純文字或 Markdown 報告。

• 專注於診斷報告與流程健康洞察，不會與文件建立或專業審查工具產生衝突。