| name | trace-task |
| description | タスクのセッション履歴を分析するスキル。 Triggers: 「T141 を分析」「タスクの履歴を見せて」「セッション履歴」 「trace task」「タスクのログ」「何が起きたか確認」等の発言。
|
trace-task: タスクセッション履歴分析
タスクに関連した全セッション(Conductor + Agent)の情報を追跡・分析する。
手順
1. セッション一覧の取得
cmux-team trace-task <task-id>
出力例:
Task T141: SESSION_CLEAR で running Conductor のステータスをリセットする
Run: task-141-1775852524
Worktree: .worktrees/task-141-1775852524
Base: origin/main @abcdef1 (source=config-origin)
Sessions:
conductor a87d71b5 surface:125 54 lines ~/.claude/projects/.../a87d71b5.jsonl
impl 1ad0d40a surface:136 77 lines ~/.claude/projects/.../1ad0d40a.jsonl
inspector xxxxxxxx surface:137 45 lines ~/.claude/projects/.../xxxxxxxx.jsonl
Base: 行は T243 で追加された worktree 出発点情報:
<label>: WorktreeBaseResolution.baseLabel(origin/main / main / HEAD 等)
@<short-sha>: worktree 作成直後の git rev-parse HEAD 先頭 7 文字
source=<source>: explicit / config-origin / config-local / head-fallback
T243 より前のタスクは情報なしで Base: - と表示される。
2. JSONL の分析
セッション一覧から JSONL パスを取得し、Read ツールで内容を確認する。
JSONL の各行は JSON オブジェクトで、主要フィールド:
type: メッセージタイプ(human, assistant, tool_use, tool_result 等)
message.content: メッセージ内容
timestamp: タイムスタンプ
大きな JSONL は offset + limit で範囲指定して読むこと。
3. 分析観点
- タイムライン: 各セッションの開始・終了時刻、所要時間
- エラー: エラーメッセージ、リトライ、失敗パターン
- 判断: Agent がどのような判断を下したか
- 成果物: 生成されたファイル、コミット
- worktree base: ヘッダの
Base: 行から worktree の base branch / 親 commit / 解決ソースを把握する(T243)。source=head-fallback のタスクは worktree が origin と乖離した HEAD から切られていた可能性があり、PR への混入 commit を確認する判断材料になる