mcpField
S
specstory-organize

specstory-organize

github.com/specstoryaiエージェントワークフロー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 対応