long-running-agent
複数のコンテキストウィンドウにまたがる大規模タスクを検出した際に自動発動。セッション分割、進捗保存、引き継ぎの最適パターンを適用する。
When & Why to Use This Skill
The Long-Running Agent skill optimizes Claude's performance for complex, large-scale tasks that exceed a single context window. It automates session splitting, progress tracking, and handovers by applying advanced context management patterns, ensuring seamless continuity and state preservation across multiple AI interactions.
Use Cases
- Large-scale software development: Managing multi-day coding projects by automatically splitting tasks into incremental sessions and tracking progress via git and feature lists.
- Context limit optimization: Automatically triggering session handovers and generating compact logs when context windows are nearly full to prevent information loss and maintain accuracy.
- Complex workflow orchestration: Coordinating sub-agents and parallel tasks for research or engineering while maintaining a centralized state through automated hooks and status files.
| name | long-running-agent |
|---|---|
| description | 複数のコンテキストウィンドウにまたがる大規模タスクを検出した際に自動発動。セッション分割、進捗保存、引き継ぎの最適パターンを適用する。 |
長期実行エージェントパターン
複数セッションにまたがる作業での最適なコンテキスト管理手法。
コア原則
1. インクリメンタル作業
- 1セッション1機能: 明確な完了条件を持つ単位で区切る
- one-shot禁止: 大きなタスクを一度に完了しようとしない
- 検証してからマーク: 機能完了時はテストで確認後にTodoを完了
2. セッション境界の設計
[セッション開始]
↓
SessionStart hook が自動注入:
- git履歴
- 直近のセッション引き継ぎ
- feature_list.json状態
↓
[作業実行]
↓
コンテキスト満杯 or 手動compact
↓
PreCompact hook が自動保存:
- ai/log/sessions/YYYY-MM-DD-HHMM-compact-{trigger}.md
↓
[セッション継続 or 終了]
セッション終了時のベストプラクティス
必須アクション
- git commit: 進捗を必ずコミット
- クリーンな状態: マージ可能な状態で残す
- TodoList更新: 完了/未完了を正確に反映
推奨アクション
- 重要な決定事項がある場合:
/save-sessionで詳細記録 - 次のタスクが明確な場合: TodoListに残す
コンテキスト効率化テクニック
情報の階層化
[常駐] CLAUDE.md → 最小限の指示のみ
[自動発動] skills → 必要時のみロード
[明示呼出] commands → ユーザー判断でロード
[独立実行] agents → コンテキスト分離
サブエージェント活用
- 試行錯誤タスク: ci-quality-checker等で独立実行
- 探索的調査: 結果のみ親に返す
- 並列処理: /orc で複数サブタスクを同時実行
機能追跡（大規模プロジェクト向け）
feature_list.json で状態管理:
{
"features": [
{
"id": "auth-001",
"description": "ユーザーがログインできる",
"priority": 1,
"passes": false
}
]
}
SessionStart hookがこのファイルを自動検出し、未完了機能を注入する。
セッション引き継ぎファイル
自動生成（PreCompact hook）
- 場所:
ai/log/sessions/YYYY-MM-DD-HHMM-compact-{trigger}.md - 内容: git状態、使用ツール、触れたファイル
- トリガー: コンテキスト満杯時、手動compact時
手動生成（/save-session）
- 場所:
ai/log/sessions/YYYY-MM-DD-HH-{suffix}.md - 内容: 詳細な作業記録、決定事項、次のアクション
- 用途: 重要な引き継ぎが必要な場合
関連コマンド
/save-session- 詳細な引き継ぎ情報を手動保存/load-session- 過去のセッション情報を読み込み/orc- 複雑タスクの並列分解・実行