名称: specstory-organize 描述: 将.specstory/history中的SpecStory AI编码会话组织到年月文件夹中。当用户说"organize my history"、“clean up specstory”、"sort my sessions"或"organize specstory files"时运行。许可证: Apache-2.0 元数据: 作者: SpecStory, Inc. 版本: “1.0.0” 参数提示: “[–dry-run]” 允许工具: Bash, Read

SpecStory Organize

通过将会话文件移动到YYYY/MM/子目录来组织您的.specstory/history目录，基于每个文件名中的时间戳。

工作原理

扫描 .specstory/history/以查找Markdown文件
提取文件名中的日期（例如，2026-01-22_19-20-56Z-fix-bug.md）
创建年月文件夹（例如，2026/01/）
移动文件到适当的子目录
报告移动的内容

为什么组织？

随着时间的推移，您的历史目录可能会积累数百个会话文件。按日期组织使得：

查找特定时间段的会话更容易
存档旧会话
保持项目目录清洁

用法

Slash Command

用户说	动作
/specstory-organize	组织所有文件（默认）
/specstory-organize dry run	预览更改而不移动
/specstory-organize --dry-run	预览更改而不移动

Direct Script Usage

# From project root
python skills/specstory-organize/scripts/organize.py

# Preview what would be moved (no changes made)
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 Output

当使用 --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.

Present Results to User

运行组织脚本后：

确认成功 - 告诉用户组织了多少文件
显示细分 - 列出每个月的文件数量
注意跳过项 - 如果文件无法解析（文件名中没有日期），提及它们

Example Response

完成！我将47个会话文件在您的.specstory/history/目录中组织好了：

- **2026/01/**: 23个文件
- **2025/12/**: 18个文件
- **2025/11/**: 6个文件

您的历史文件现在按年和月排序，使得查找特定时间段的会话更加容易。

Notes

文件名中没有可识别日期模式的文件会被跳过
脚本使用文件名时间戳，而不是文件的修改时间
已经组织的文件（在子目录中）不会再次移动
兼容Python 2.7+和Python 3.x