mcpField
S
specstory-organize

specstory-organize

github.com/specstoryaiAgent 工作流35284 次安装39 周前更新
代码仓库

关于 specstory-organize

specstory-organize 是整理 SpecStory 会话历史文件的技能，适用于希望按时间归档项目记录的开发者。它从文件名读取日期，将 Markdown 文件移入按年和月划分的目录，并支持预览变更。

主要功能

  1. 01扫描 .specstory/history 中的 Markdown 文件
  2. 02从文件名提取日期
  3. 03按年和月创建目录并移动文件
  4. 04提供变更预览模式
  5. 05跳过无法识别日期的文件

适用场景

  1. 01整理不断累积的会话记录
  2. 02按月份查找历史会话
  3. 03移动文件前预览整理结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/specstoryai/agent-skills --skill specstory-organize

安装后在 Claude Code 中输入/specstory-organize确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
README.md
scripts/
organize.py

详细介绍

SpecStory Organize

根据文件名中的时间戳，将 .specstory/history 目录中的会话文件移动到 YYYY/MM/ 子目录中进行整理。

工作原理

  1. 扫描 .specstory/history/ 中的 Markdown 文件
  2. 提取文件名中的日期（例如，2026-01-22_19-20-56Z-fix-bug.md）
  3. 创建年/月文件夹（例如，2026/01/）
  4. 移动文件到相应的子目录
  5. 报告移动情况

为什么要整理？

随着时间推移，历史记录目录中可能会积累数百个会话文件。按日期整理可以更轻松地：

  • 查找特定时间段内的会话
  • 归档旧会话
  • 保持项目目录整洁

用法

斜杠命令
用户说操作
/specstory-organize整理所有文件（默认）
/specstory-organize dry run预览更改，不移动文件
/specstory-organize --dry-run预览更改，不移动文件
直接使用脚本
# 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 时：

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.

向用户展示结果

运行整理脚本后：

  1. 确认成功 - 告知用户整理了多少个文件
  2. 展示分类情况 - 列出每个月整理了多少个文件
  3. 说明跳过情况 - 如果有文件无法解析（文件名中没有日期），请说明
响应示例
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

评论

支持 Markdown