SpecStory Organize 用于整理 SpecStory AI 编程会话历史。它把 .specstory/history 目录中的会话文件按文件名中的时间戳移动到 YYYY/MM 子目录中，使历史记录按年、月归档。
用途
随着使用时间增长，.specstory/history 目录可能积累数百个会话文件。按日期整理后，可以更方便地查找特定时间段的会话、归档旧会话，并保持项目目录整洁。
主要能力
- 扫描 .specstory/history/ 中的 Markdown 文件。
- 从文件名中提取日期，例如 2026-01-22_19-20-56Z-fix-bug.md。
- 创建年/月文件夹，例如 2026/01/。
- 将文件移动到对应的子目录。
- 报告移动了哪些文件。
使用方式
斜杠命令：
- /specstory-organize：整理所有文件（默认）。
- /specstory-organize dry run：预览更改，不移动文件。
- /specstory-organize --dry-run：预览更改，不移动文件。
直接运行脚本（从项目根目录）：
- python skills/specstory-organize/scripts/organize.py
- python skills/specstory-organize/scripts/organize.py --dry-run（预览将要移动的内容，不实际更改）
输出示例
SpecStory History Organizer
Found 47 files to organize in .specstory/history/
Moving files: 2026-01-15_10-30-22Z-refactor-auth.md -> 2026/01/ 2026-01-15_14-22-01Z-fix-tests.md -> 2026/01/ 2026-01-22_19-20-56Z-add-feature.md -> 2026/01/ 2025-12-28_09-15-33Z-cleanup.md -> 2025/12/ ...
Summary:
Files moved: 47 2026/01/: 23 files 2025/12/: 18 files 2025/11/: 6 files
Your history is now organized!
Dry Run 输出
使用 --dry-run 时：
SpecStory History Organizer (DRY RUN)
Would organize 47 files in .specstory/history/
Preview: 2026-01-15_10-30-22Z-refactor-auth.md -> 2026/01/ 2026-01-15_14-22-01Z-fix-tests.md -> 2026/01/ ...
No files were moved. Run without --dry-run to apply changes.
向用户呈现结果
运行整理脚本后：
- 确认成功：告知用户整理了多少个文件。
- 显示分布：列出每个月移动了多少文件。
- 说明跳过项：如果文件无法解析（文件名中没有日期），需要提及。
示例回复：
Done! I organized 47 session files in your .specstory/history/ directory:
- 2026/01/: 23 files
- 2025/12/: 18 files
- 2025/11/: 6 files
Your history files are now sorted by year and month, making it much easier to find sessions from specific time periods.
适用场景
- 历史目录中会话文件过多，需要按时间归档。
- 需要查找某个特定时间段的会话记录。
- 希望保持项目目录整洁。
限制与注意事项
- 文件名中没有可识别日期模式的文件会被跳过。
- 脚本使用文件名中的时间戳，而不是文件的修改时间。
- 已经整理过的文件（位于子目录中）不会被再次移动。
- 兼容 Python 2.7+ 和 Python 3.x。