Agent skill · writing content · affaan-m
code-tour
CodeTour `.tour`ファイルを作成 — ペルソナターゲット、ステップバイステップウォークスルー（実際のファイルとラインアンカー付き）。オンボーディングツアー、アーキテクチャウォークスルー、PRツアー、RCAツアー、構造化「これがどのように機能するかを説明」リクエストに使用。
Why this skill is useful
Provides a structured template for creating CodeTour `.tour` files that enhances onboarding and walkthrough processes.
What it needs
About 1k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
コードツアー コードベースウォークスルー用のCodeTour .tourファイルを作成し、実際のファイルとラインの範囲に直接開きます。ツアーは.tours/にあり、アドホックなMarkdownノートではなくCodeTour形式を対象としています。 良いツアーは特定の読者への物語： 彼らが何を見ているか なぜそれが重要か 次にどのパスを従うべきか .tour JSONファイルのみを作成。このスキルの一部としてソースコードを変更しないでください。 使用時期 次の場合にこのスキルを使用： ユーザーがコードツアー、オンボーディングツアー、アーキテクチャウォークスルー、またはPRツアーを求める ユーザーが「Xがどのように機能するかを説明」と言い、再利用可能なガイド付きアーティファクトを望む 新しいエンジニアまたはレビュアーのためのランプアップパス タスクはフラット概要ではなくガイド付きシーケンスでより良くサービスされる 使用しないとき コードツアーの代わりに 使用 --- --- 一度限りの説明で十分 直接答える ユーザーがプロのドキュメント、.tourアーティファクトではなく ドキュメント編集 タスクは実装またはリファクタリング 実装作業を行う 広範なコードベースオンボーディング codebase-onboarding ワークフロー 1. 発見 何か書く前にリポを探索： READMEとパッケージ/アプリエントリポイント フォルダ構造 関連するコンフィグファイル ツアーがPRフォーカスの場合は変更されたファイル コードの形状を理解する前にステップを書き始めないでください。 2. 読者を推測 要求からペルソナと深さを決定。 リクエストの形 ペルソナ 推奨される深さ --- --- --- 「オンボーディング」「新しい参加者」 new-joiner 9-13ステップ ツアー形式 Code Tour .tourファイルはJSON形式で、各ステップはファイルパス、ライン番号、説明を含みます。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/code-tour--cbc451