CodeTour `.tour`ファイルを作成 — ペルソナターゲット、ステップバイステップウォークスルー(実際のファイルとラインアンカー付き)。オンボーディングツアー、アーキテクチャウォークスルー、PRツアー、RCAツアー、構造化「これがどのように機能するかを説明」リクエストに使用。
Install
npx skills add https://github.com/affaan-m/ecc --skill code-tourSKILL.md
コードツアー
コードベースウォークスルー用のCodeTour .tourファイルを作成し、実際のファイルとラインの範囲に直接開きます。ツアーは.tours/にあり、アドホックなMarkdownノートではなくCodeTour形式を対象としています。
良いツアーは特定の読者への物語:
- 彼らが何を見ているか
- なぜそれが重要か
- 次にどのパスを従うべきか
.tour JSONファイルのみを作成。このスキルの一部としてソースコードを変更しないでください。
使用時期
次の場合にこのスキルを使用:
- ユーザーがコードツアー、オンボーディングツアー、アーキテクチャウォークスルー、またはPRツアーを求める
- ユーザーが「Xがどのように機能するかを説明」と言い、再利用可能なガイド付きアーティファクトを望む
- 新しいエンジニアまたはレビュアーのためのランプアップパス
- タスクはフラット概要ではなくガイド付きシーケンスでより良くサービスされる
使用しないとき
| コードツアーの代わりに | 使用 |
|---|---|
| 一度限りの説明で十分 | 直接答える |
ユーザーがプロのドキュメント、.tourアーティファクトではなく |
ドキュメント編集 |
| タスクは実装またはリファクタリング | 実装作業を行う |
| 広範なコードベースオンボーディング | codebase-onboarding |
ワークフロー
1. 発見
何か書く前にリポを探索:
- READMEとパッケージ/アプリエントリポイント
- フォルダ構造
- 関連するコンフィグファイル
- ツアーがPRフォーカスの場合は変更されたファイル
コードの形状を理解する前にステップを書き始めないでください。
2. 読者を推測
要求からペルソナと深さを決定。
| リクエストの形 | ペルソナ | 推奨される深さ |
|---|---|---|
| 「オンボーディング」「新しい参加者」 | new-joiner |
9-13ステップ |
ツアー形式
Code Tour .tourファイルはJSON形式で、各ステップはファイルパス、ライン番号、説明を含みます。
Related skills
domain-modelingmattpocock714KBuild and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.to-specmattpocock576KTurn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.caveman-helpjuliusbrussee369KQuick-reference card for caveman modes, skills and commands. Trigger: /caveman-help or "caveman help".pptxanthropics228KUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the u