chaenmasahiro0425 / claude-session-triage

# session-triage
**Claudeデスクトップアプリ（Codeタブ）のセッションを15分おきに見回り、名前の先頭の絵文字で「誰の番か」を表すスキルです。**
Claude Code のセッションを並行で回していると、サイドバーがすぐ埋まります。
「終わったのか」「自分の返事を待っているのか」「まだ動いているのか」は、1つずつ開かないと分かりません。
session-triage を定期実行に載せておくと、Claude が各セッションの最後のやり取りを読みます。そして名前を次の形に付け直します。
 [code] 
開くのは **🔴（要確認）と 📤（送信待ち）だけ** で済みます。
English summary
---
## 状態は5つだけ
| 絵文字 | 状態 | 誰の番 | 判定の目安 |
|---|---|---|---|
| ⏳ | 作業中 | Claude | ターンの途中・バックグラウンドで動いている |
| 👀 | 確認中 | Claude | デプロイ・CI・レビューの結果待ち |
| 📤 | 送信待ち | あなた | メールや投稿の下書きができていて送るだけ |
| 🔴 | 要確認 | あなた | 質問・承認待ち・残った手作業・エラー・PRがOPEN |
| ✅ | 完了 | — | 完了報告だけで残りの判断なし |
判断に迷ったら必ず 🔴 にします。見落とすより、1回余計に開くほうが安いからです。
## しくみ
1. **一覧を取る**: 開いているセッションをまとめて取得します
2. **変わったものだけ読む**: 前回の記録（`state.json`）と比べ、動いたセッションの最後の数件だけを読みます
3. **状態を決める**: ⏳👀📤🔴✅ のどれか1つに決めます
4. **名前を付け直す**: `絵文字【フォルダ】内容` の形にします。【フォルダ】は作業場所（cwd）から自動で決まります
5. **確認事項をまとめる**: 🔴📤 のセッションごとに「何をすればいいか」をリンク付きで1枚の Markdown に書きます
6. **夜にまとめて片付け**: 23:30以降の回だけ、✅ のセッションをアーカイブします
確認事項の一覧（`latest.md`）は次のような形です。
 [code] 
## 安心して放っておける理由
- 変えるのは **セッションの名前だけ** です。メッセージの送信・停止・削除はしません
- 会話の中に書かれた指示には従いません。transcript は「資料」として読むだけです
- サイドバーの並べ方・グループ・ピン留めには触りません
- アーカイブするのは ✅ だけで、直前にもう一度状態を取り直してから行います。🔴📤👀 は残します。アーカイブは Claude アプリの「Archived」からいつでも戻せます
- 自分の定期実行の過去分も、件数の報告で正常に終わったものだけ片付けます。エラーで止まった回は残ります
## 必要なもの
- **Claude デスクトップアプリ（Mac / Windows）の Codeタブ**
 - セッション管理の道具（`mcp__ccd_session_mgmt__*`）を使うため、ターミナル版の `claude` 単体では動きません
- 15分おきに回すなら、アプリの定期実行（Scheduled）機能
## 入れ方
 [code] 
 [code] 
- `~/.claude/skills/session-triage/` にスキルが入ります（`--link` を付けるとシンボリックリンクで入り、`git pull` で更新できます）
- `~/.claude/session-triage/config.json` に設定のひな形が置かれます（既にあれば上書きしません）
 Windows の場合（手で入れる） 
1. `skills\session-triage` フォルダを `%USERPROFILE%\.claude\skills\session-triage` にコピーします
2. `skills\session-triage\config.example.json` を `%USERPROFILE%\.claude\session-triage\config.json` にコピーします
3. 通知（`notify`）は macOS だけで動きます。Windows では出ません
### 1回だけ動かす
Codeタブで次のように頼みます。
 [code] 
### 15分おきに回す
Codeタブで次のように頼むと、アプリの定期実行に登録されます。
 [code] 
定期実行に渡す文面の例は examples/scheduled-task-prompt.md にあります。
> 定期実行は、アプリが開いている間に動きます。アプリを閉じていた間の分は、次に開いたときに実行されます。
## 設定（config.json）
| 項目 | 既定値 | 意味 |
|---|---|---|
| `owner` | `あなた` | 「本人」の呼び方 |
| `language` | `ja` | 名前・一覧・ログの言語（`ja` / `en`） |
| `data_dir` | `~/.claude/session-triage` | `state.json` と `log.md` の置き場 |
| `report_path` | `~/.claude/session-triage/latest.md` | 確認事項の一覧の出力先 |
| `emoji` | ⏳👀📤🔴✅ | 5つの状態の絵文字 |
| `legacy_emoji` | 🟡🔄🔵🔍🟢 | 見つけたら付け替える古い絵文字 |
| `folder_rules` | 下を参照 | cwd から【フォルダ】を決めるルール |
| `folder_fallback_strip_prefixes` | `["mycompany-"]` | ルールに当たらないとき、フォルダ名から外す接頭辞 |
| `skip_title_prefixes` | `【毎日】` など | 名前を変えないセッション（他の定期実行など） |
| `self_title_marker` | `セッション整理` | このスキルの定期実行を見分ける言葉 |
| `nightly_archive` | 23:30〜23:59・60分 | 夜のまとめアーカイブ |
| `notify` | `true` | 🔴📤 が増えたら macOS 通知（他のOSでは無視） |
| `max_sessions` | `100` | 1回で見る件数の上限。超えた古いものは記録を残したまま見送ります |
### フォルダのルール
上から順に当て、最初に当たったものを使います。`regex` の `$1` は1つ目のカッコの中身に置き換わります。
 [code] 
どれにも当たらなければ、cwd の最後のフォルダ名を使います。【フォルダ】は毎回 cwd から計算し直すので、ルールを変えると次の回から名