# Trace Task

> タスクのセッション履歴を分析するスキル。 Triggers: 「T141 を分析」「タスクの履歴を見せて」「セッション履歴」 「trace task」「タスクのログ」「何が起きたか確認」等の発言。

- Skill: `hummer98/trace-task` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hummer98/trace-task`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hummer98/trace-task/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hummer98 (https://skillmd.com/u/hummer98)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hummer98/trace-task

---


# trace-task: タスクセッション履歴分析

タスクに関連した全セッション（Conductor + Agent）の情報を追跡・分析する。

## 手順

### 1. セッション一覧の取得

```bash
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 を確認する判断材料になる