Explain Comment

---
name: explain-comment
description: "指定されたファイルまたは範囲のコードを読み込み、重要な部分に Conductor の説明コメント（question 形式）を追加する。"
disable-model-invocation: true
---

# Explain Comment

指定されたファイルまたは範囲のコードを読み込み、重要な部分に説明コメントを追加する。

$ARGUMENTS

## 手順

### 1. 対象コードを読み込む

`$ARGUMENTS` で指定されたファイルパス（およびオプションの行範囲）を Read ツールで読み込む。

- `src/app.rs` — ファイル全体
- `src/app.rs:10-50` — 行範囲指定
- 引数が空の場合、現在 Viewer で開いているファイルを対象とする

### 2. コードを分析

読み込んだコードの中から、説明が有用な箇所を特定する：

- **関数・メソッド定義** — 目的、引数、戻り値の意味
- **構造体・列挙型** — 各フィールドの役割、設計意図
- **複雑なロジック** — アルゴリズム、条件分岐の理由、エッジケース処理
- **パターン・慣用句** — Rust 固有のパターン（ライフタイム、トレイト境界等）
- **重要な副作用** — DB 操作、ファイル I/O、状態変更

自明なコード（getter/setter、単純な代入等）にはコメントを追加しない。

### 3. 説明コメントを追加

各箇所に対して `mcp__conductor__create_comment` を使用してコメントを追加する。

```
mcp__conductor__create_comment:
  file_path: <対象ファイルの相対パス>
  line_start: <開始行番号>
  line_end: <終了行番号（省略可）>
  body: <説明文>
  kind: "question"
```

#### コメント作成のガイドライン

- **簡潔かつ正確に** — 1〜3文で要点を伝える
- **「なぜ」を重視** — 何をしているかではなく、なぜそうしているかを説明
- **コンテキストを含める** — 他のモジュールとの関係、設計判断の背景
- **日本語で記述** — ユーザーの言語に合わせる
- **kind は `"question"` を使用** — 説明コメントは質問形式（❓）で統一

#### コメント例

良い例:
- `この HashMap キャッシュは、毎フレームの O(n) スキャンを避けるため。ファイル変更時に invalidate する`
- `git2 の diff は working tree 差分を返すが、ここでは HEAD との差分が必要なので reverse している`

悪い例:
- `Vec を作成している` （自明）
- `for ループ` （コードを読めばわかる）

### 4. 複数箇所は並列実行

独立した箇所のコメント追加は並列で実行する。同一ファイルの近い行に対する複数コメントも並列実行可能。

### 5. サマリーを報告

追加したコメントの一覧を報告する：

```
## Explain Comment 完了

### 追加したコメント
| 行 | 対象 | 説明の要約 |
|----|------|-----------|
| L42 | `process_data()` | データ変換パイプラインの概要 |
| L78-85 | match 式 | エラーリカバリ戦略の説明 |
| ... | ... | ... |

合計: N 件のコメントを追加
```

## 重要

- コメントはコードファイルに直接書き込むのではなく、**Conductor の code comment 機能**（`mcp__conductor__create_comment`）を使って追加する
- 追加されたコメントは Conductor の Viewer パネルで 💬 マークとして表示される
- 関連する MCP ツール（`mcp__conductor__reply_to_comment` 等）も必要に応じて活用してよい