メニュー
실제 파일과 라인 앵커를 가진 CodeTour `.tour` 파일을 만듭니다. 온보딩 투어, 아키텍처 워크스루, PR 투어, RCA 투어, 구조화된 "이게 어떻게 동작하는지 설명해줘" 요청에 사용합니다.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/SAM42-Lab/everything-claude-code-kr --skill code-tourコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | code-tour |
| description | 실제 파일과 라인 앵커를 가진 CodeTour `.tour` 파일을 만듭니다. 온보딩 투어, 아키텍처 워크스루, PR 투어, RCA 투어, 구조화된 "이게 어떻게 동작하는지 설명해줘" 요청에 사용합니다. |
| origin | ECC |
실제 파일과 라인 범위로 바로 열리는 코드베이스 워크스루용 CodeTour .tour 파일을 만듭니다. 투어는 .tours/에 저장되며, 임시 Markdown 메모가 아니라 CodeTour 형식용 산출물입니다.
좋은 투어는 특정 독자를 위한 내러티브입니다.
이 스킬은 .tour JSON 파일만 만듭니다. 소스 코드는 수정하지 않습니다.
다음 경우 이 스킬을 사용합니다.
"explain how X works"라고 하며 재사용 가능한 가이드형 산출물을 원할 때예시:
| code-tour 대신 | 사용 |
|---|---|
| 채팅으로 한 번 설명하면 충분할 때 | 직접 답변 |
.tour 산출물이 아니라 문서형 설명이 필요할 때 | documentation-lookup 또는 저장소 문서 편집 |
| 구현이나 리팩터링 작업일 때 | 구현 작업 수행 |
| 투어 산출물 없는 광범위 코드베이스 온보딩일 때 | codebase-onboarding |
무언가를 쓰기 전에 저장소를 먼저 탐색합니다.
코드의 형태를 이해하기 전에 step을 쓰기 시작하지 않습니다.
요청에서 페르소나와 깊이를 판단합니다.
| 요청 형태 | 페르소나 | 권장 깊이 |
|---|---|---|
"onboarding", "new joiner" | new-joiner | 9-13 steps |
"quick tour", "vibe check" | vibecoder | 5-8 steps |
"architecture" | architect | 14-18 steps |
"tour this PR" | pr-reviewer | 7-11 steps |
"why did this break" | rca-investigator | 7-11 steps |
"security review" | security-reviewer | 7-11 steps |
"explain how this feature works" | feature-explainer | 7-11 steps |
"debug this path" | bug-fixer | 7-11 steps |
모든 파일 경로와 라인 앵커는 실제여야 합니다.
라인 번호를 추측하지 않습니다.
.tour 작성다음 경로에 작성합니다.
.tours/<persona>-<focus>.tour
경로는 결정론적이고 읽기 쉬워야 합니다.
마무리 전에 다음을 확인합니다.
주로 마지막 step처럼, 꼭 필요할 때만 제한적으로 사용합니다.
{ "title": "Next Steps", "description": "You can now trace the request path end to end." }
첫 번째 step을 content-only로 만들지 않습니다.
모듈 방향을 잡아줄 때 사용합니다.
{ "directory": "src/services", "title": "Service Layer", "description": "The core orchestration logic lives here." }
기본 step 유형입니다.
{ "file": "src/auth/middleware.ts", "line": 42, "title": "Auth Gate", "description": "Every protected request passes here first." }
파일 전체보다 특정 코드 블록이 중요할 때 사용합니다.
{
"file": "src/core/pipeline.ts",
"selection": {
"start": { "line": 15, "character": 0 },
"end": { "line": 34, "character": 0 }
},
"title": "Request Pipeline",
"description": "This block wires validation, auth, and downstream execution."
}
정확한 라인이 자주 흔들릴 때 사용합니다.
{ "file": "src/app.ts", "pattern": "export default class App", "title": "Application Entry" }
PR, 이슈, 문서가 유용할 때 사용합니다.
{ "uri": "https://github.com/org/repo/pull/456", "title": "The PR" }
각 설명은 다음에 답해야 합니다.
설명은 짧고, 구체적이며, 실제 코드에 근거해야 합니다.
특별한 이유가 없다면 다음 흐름을 사용합니다.
투어는 목록이 아니라 경로처럼 느껴져야 합니다.
{
"$schema": "https://aka.ms/codetour-schema",
"title": "API Service Tour",
"description": "Walkthrough of the request path for the payments service.",
"ref": "main",
"steps": [
{
"directory": "src",
"title": "Source Root",
"description": "All runtime code for the service starts here."
},
{
"file": "src/server.ts",
"line": 12,
"title": "Entry Point",
"description": "The server boots here and wires middleware before any route is reached."
},
{
"file":
| 안티패턴 | 수정 방향 |
|---|---|
| 평면적인 파일 나열 | step 간 의존성과 흐름이 있는 이야기로 바꾸기 |
| 일반적이고 모호한 설명 | 실제 코드 경로나 패턴을 구체적으로 적기 |
| 추측한 앵커 | 모든 파일과 라인을 먼저 검증 |
| 짧은 투어인데 step 수가 너무 많음 | 과감하게 줄이기 |
| 첫 step이 content-only | 실제 파일이나 디렉터리에 앵커링 |
| 페르소나 불일치 | 일반 엔지니어가 아니라 실제 독자를 기준으로 작성 |
codebase-onboardingcoding-standardscouncilmicrosoft/codetour