code-tour

# コードツアー コードベースウォークスルー用のCodeTour `.tour`ファイルを作成し、実際のファイルとラインの範囲に直接開きます。ツアーは`.tours/`にあり、アドホックなMarkdownノートではなくCodeTour形式を対象としています。 良いツアーは特定の読者への物語： - 彼らが何を見ているか - なぜそれが重要か - 次にどのパスを従うべきか `.tour` JSONファイルのみを作成。このスキルの一部としてソースコードを変更しないでください。 ## 使用時期 次の場合にこのスキルを使用： - ユーザーがコードツアー、オンボーディングツアー、アーキテクチャウォークスルー、またはPRツアーを求める - ユーザーが「Xがどのように機能するかを説明」と言い、再利用可能なガイド付きアーティファクトを望む - 新しいエンジニアまたはレビュアーのためのランプアップパス - タスクはフラット概要ではなくガイド付きシーケンスでより良くサービスされる ## 使用しないとき | コードツアーの代わりに | 使用 | | --- | --- | | 一度限りの説明で十分 | 直接答える | | ユーザーがプロのドキュメント、`.tour`アーティファクトではなく | ドキュメント編集 | | タスクは実装またはリファクタリング | 実装作業を行う | | 広範なコードベースオンボーディング | `codebase-onboarding` | ## ワークフロー ### 1. 発見 何か書く前にリポを探索： - READMEとパッケージ/アプリエントリポイント - フォルダ構造 - 関連するコンフィグファイル - ツアーがPRフォーカスの場合は変更されたファイル コードの形状を理解する前にステップを書き始めないでください。 ### 2. 読者を推測 要求からペルソナと深さを決定。 | リクエストの形 | ペルソナ | 推奨される深さ | | --- | --- | --- | | 「オンボーディング」「新しい参加者」 | `new-joiner` | 9-13ステップ | ## ツアー形式 Code Tour `.tour`ファイルはJSON形式で、各ステップはファイルパス、ライン番号、説明を含みます。