name: specstory-organize description: 将.specstory/history中的SpecStory AI编码会话组织到年/月文件夹中。当用户说“组织我的历史”、“清理specstory”、“排序我的会话”或“组织specstory文件”时运行。 license: Apache-2.0 metadata: author: SpecStory, Inc. version: “1.0.0” argument-hint: “[–dry-run]” allowed-tools: Bash, Read
SpecStory 整理工具
根据每个文件名中的时间戳，将您的.specstory/history目录中的会话文件移动到YYYY/MM/子目录中。
工作原理
- 扫描
.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