revert

revert 技能是一款精密的安全回滾代理程式，專為在複雜開發流程中維持專案完整性而設計。與基於單一提交（commit-by-commit）運作的標準 git revert 不同，此技能能夠理解由 metadata.json 和 plan.md 管理的專案邏輯結構。它允許開發者透過識別所有相關提交、追蹤檔案變更並執行自動化的狀態驗證，來撤銷整個追蹤、特定階段或個別任務，確保程式碼庫在復原後保持一致。此工具適用於需要維護乾淨 Git 歷史記錄，同時管理多階段開發任務的軟體工程師與主管。

• 根據與特定任務、階段或追蹤相關聯的提交進行邏輯分組。

• 強制性的多階段撤銷工作流程，包含影響分析與使用者確認閘門。

• 在 Git 儲存庫、metadata.json 與專案 plan.md 檔案之間自動進行狀態同步。

• 預設執行安全回滾（建立復原提交而非使用破壞性的強制推送），以維護專案的可審計性。

• 復原後驗證，包含專案品質檢查與一致性報告。

• 輸入：使用者請求，指定要復原的範圍（追蹤、階段或任務）。

• 操作：分析歷史、列出受影響的檔案與提交、要求明確的使用者確認、執行復原，並更新專案文件。

• 約束：必須嚴格遵守 5 階段任務生命週期；操作前務必進行預覽；高風險操作必須獲得手動確認。

• 適用場景：從失敗的功能實作中復原、撤銷實驗性工作，或在結構化的工程環境中清理過期的任務。