From ecc
실제 파일과 라인 앵커를 가진 CodeTour `.tour` 파일을 만듭니다. 온보딩 투어, 아키텍처 워크스루, PR 투어, RCA 투어, 구조화된 "이게 어떻게 동작하는지 설명해줘" 요청에 사용합니다.
npx claudepluginhub sam42-lab/everything-claude-code-krThis skill uses the workspace's default tool permissions.
실제 파일과 라인 범위로 바로 열리는 코드베이스 워크스루용 **CodeTour** `.tour` 파일을 만듭니다. 투어는 `.tours/`에 저장되며, 임시 Markdown 메모가 아니라 CodeTour 형식용 산출물입니다.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
실제 파일과 라인 범위로 바로 열리는 코드베이스 워크스루용 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": "src/routes/payments.ts",
"line": 8,
"title": "Payment Routes",
"description": "Every payments request enters through this router before hitting service logic."
},
{
"title": "Next Steps",
"description": "You can now follow any payment request end to end with the main anchors in place."
}
]
}
| 안티패턴 | 수정 방향 |
|---|---|
| 평면적인 파일 나열 | step 간 의존성과 흐름이 있는 이야기로 바꾸기 |
| 일반적이고 모호한 설명 | 실제 코드 경로나 패턴을 구체적으로 적기 |
| 추측한 앵커 | 모든 파일과 라인을 먼저 검증 |
| 짧은 투어인데 step 수가 너무 많음 | 과감하게 줄이기 |
| 첫 step이 content-only | 실제 파일이나 디렉터리에 앵커링 |
| 페르소나 불일치 | 일반 엔지니어가 아니라 실제 독자를 기준으로 작성 |
codebase-onboardingcoding-standardscouncilmicrosoft/codetour