名称: 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 整理

通过基于每个文件名中的时间戳将会话文件移动到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 历史整理器
===========================

在 .specstory/history/ 中找到 47 个文件需要整理

移动文件：
  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/
  ...

摘要：
--------
移动文件数：47
  2026/01/: 23 个文件
  2025/12/: 18 个文件
  2025/11/: 6 个文件

您的历史文件现已整理完成！

干运行输出

使用 --dry-run 时：

SpecStory 历史整理器（干运行）
=====================================

将整理 .specstory/history/ 中的 47 个文件

预览：
  2026-01-15_10-30-22Z-refactor-auth.md -> 2026/01/
  2026-01-15_14-22-01Z-fix-tests.md -> 2026/01/
  ...

没有移动任何文件。运行时不带 --dry-run 以应用更改。

向用户呈现结果

运行整理脚本后：

确认成功 - 告诉用户整理了多少个文件
显示细分 - 列出每个月有多少个文件
注意任何跳过 - 如果有文件无法解析（文件名中无日期），请提及

示例响应

完成！我整理了您的 `.specstory/history/` 目录中的 47 个会话文件：

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

您的历史文件现已按年和月排序，更容易找到特定时间段的会话。

备注

文件名中无识别日期模式的文件将被跳过
脚本使用文件名时间戳，而非文件的修改时间
已整理的文件（在子目录中）不会再次移动
兼容 Python 2.7+ 和 Python 3.x