specstory-organize

specstory-organize 技能為使用 SpecStory 進行 AI 輔助編碼的開發人員提供了流暢且自動化的工作流程。隨著專案發展，.specstory/history/ 目錄通常會累積數百個 Markdown 檔案，導致難以搜尋特定對話、管理專案封存或維持工作區整潔。此技能會系統性地掃描您的歷史紀錄目錄，提取嵌入在檔案名稱中的日期資訊，並將這些檔案遷移至按年與月分類的子目錄中 (例如 2026/01/)。其設計目標在於確保高度的可靠性，在維持專案結構清晰的同時，僅移動合規的檔案。

• 透過解析檔案名稱中的時間戳記，自動將 Markdown 檔案進行分類管理。

• 透過建立可擴充的 YYYY/MM 目錄結構，有效解決歷史紀錄根目錄過於雜亂的問題。

• 支援乾跑 (Dry-run) 執行模式，讓您在實際變更磁碟之前，先行預覽檔案遷移路徑。

• 相容於部署了 Claude Code、Cursor 或類似 CLI 介面 AI 輔助編碼工具的多元環境。

• 對於大型歷史紀錄集具有安全性，僅會移動未整理的檔案，並自動略過已分類的內容。

• 非常適合需要對 AI 互動日誌進行簡化封存策略的頻繁 AI 輔助編碼使用者。

• 執行整理程序時，請直接使用斜線指令 /specstory-organize，或是從專案根目錄呼叫 Python 指令碼。

• 建議在執行時加入 --dry-run 參數，以便在確認變更檔案系統之前安全地審核受影響的檔案列表。

• 請注意，本技能依賴檔案名稱中的時間格式，而非作業系統的檔案修改時間，這確保了在不同檔案系統間的一致性。

• 檔案名稱不含可辨識日期格式或是已位於子目錄中的檔案，將被指令碼自動忽略以避免誤操作。

• 本工具設計適用於標準 POSIX 環境，並支援 Python 2.7+ 及 3.x 版本。