Code Tour

---
name: code-tour
description: CodeTour `.tour`ファイルを作成 — ペルソナターゲット、ステップバイステップウォークスルー（実際のファイルとラインアンカー付き）。オンボーディングツアー、アーキテクチャウォークスルー、PRツアー、RCAツアー、構造化「これがどのように機能するかを説明」リクエストに使用。
origin: ECC
---

# コードツアー

コードベースウォークスルー用のCodeTour `.tour`ファイルを作成し、実際のファイルとラインの範囲に直接開きます。ツアーは`.tours/`にあり、アドホックなMarkdownノートではなくCodeTour形式を対象としています。

良いツアーは特定の読者への物語：
- 彼らが何を見ているか
- なぜそれが重要か
- 次にどのパスを従うべきか

`.tour` JSONファイルのみを作成。このスキルの一部としてソースコードを変更しないでください。

## 使用時期

次の場合にこのスキルを使用：
- ユーザーがコードツアー、オンボーディングツアー、アーキテクチャウォークスルー、またはPRツアーを求める
- ユーザーが「Xがどのように機能するかを説明」と言い、再利用可能なガイド付きアーティファクトを望む
- 新しいエンジニアまたはレビュアーのためのランプアップパス
- タスクはフラット概要ではなくガイド付きシーケンスでより良くサービスされる

## 使用しないとき

| コードツアーの代わりに | 使用 |
| --- | --- |
| 一度限りの説明で十分 | 直接答える |
| ユーザーがプロのドキュメント、`.tour`アーティファクトではなく | ドキュメント編集 |
| タスクは実装またはリファクタリング | 実装作業を行う |
| 広範なコードベースオンボーディング | `codebase-onboarding` |

## ワークフロー

### 1. 発見

何か書く前にリポを探索：
- READMEとパッケージ/アプリエントリポイント
- フォルダ構造
- 関連するコンフィグファイル
- ツアーがPRフォーカスの場合は変更されたファイル

コードの形状を理解する前にステップを書き始めないでください。

### 2. 読者を推測

要求からペルソナと深さを決定。

| リクエストの形 | ペルソナ | 推奨される深さ |
| --- | --- | --- |
| 「オンボーディング」「新しい参加者」 | `new-joiner` | 9-13ステップ |

## ツアー形式

Code Tour `.tour`ファイルはJSON形式で、各ステップはファイルパス、ライン番号、説明を含みます。