ctx-planning

ctx-planning 是一款專為軟體工程師與專案經理打造的先進任務管理與報告助理，旨在優化結構化任務追蹤流程。透過與儲存庫層級的待辦清單 (backlog) 及設定檔直接整合，本工具能有效將原始任務列表轉換為具體且可執行的每日與每週工作流程。此代理工具會根據設定的工作進行中 (WIP) 上限、專案優先級及自訂的決勝規則，評估待處理任務，確保開發者專注於高影響力目標，同時維持良好的專案負載平衡。對於管理多個儲存庫或複雜專案架構的團隊而言，此工具在任務匯總與進度透明化方面極為高效。它透過自動化繁瑣的報告與文件編寫工作，成為執行力與高階規劃之間的橋樑。

• 自動應用自訂的 WIP 上限以平衡工作負載，預防過度勞累並確保任務準時交付。

• 利用 P1/P2/P3 分級系統動態處理任務優先級，並包含智慧決勝規則（如：優先處理阻塞項或優先處理小型快速任務）。

• 支援生成標準化的 Markdown 報告，涵蓋每日規劃、每日工作總結 (EoD)、每週專案概覽及每月回顧分析。

• 整合版本控制自動化，針對所有產生的規劃報告自動執行 git commit 與 git push 操作。

• 將個人任務執行與 BaseContext.yaml 中設定的長期月度目標對齊，並標記高風險里程碑以便採取主動應變措施。

• 在執行規劃工作流程之前，請務必先執行 /ctx.scan 指令，以確保 state/backlog.yaml 檔案已更新且資訊準確。

• 本工具高度依賴本地狀態檔案 (state/backlog.yaml 與 state/carryover.yaml)，建議將其納入儲存庫管理以維護跨團隊協作的一致性。

• 若需修改任務上限或專案權重等規劃參數，請使用 /ctx.update 工作流程，無需觸發完整的報告重新生成。

• 輸出內容包含每日與每週檢視的標準化模板，使用者可於 templates/ 目錄下進行自訂，以適應特定的專案需求。

• 特別適用於任務導向的工作環境，讓開發者或領導者能在不需手動製作文件的情況下，快速總結成就、記錄阻塞事項並制定隔日計畫。