Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Create CodeTour `.tour` files — persona-targeted, step-by-step walkthroughs with real file and line anchors. Use for onboarding tours, architecture walkthroughs, PR tours, RCA tours, and structured "explain how this works" requests.
| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-11 | ✗→✓ | ▲ Improved | 349% | 0% |
| case-12 | ✗→✓ | ▲ Improved | 68% | 0% |
| case-13 | ✗→✓ | ▲ Improved | 87% | 0% |
| case-21 | ✗→✓ | ▲ Improved | 47% | 0% |
| case-07 | ✓→✗ | ▼ Worse | -9% | 0% |
创建 CodeTour .tour 文件，用于代码库导览，可直接打开真实文件并定位到指定行范围。导览文件存放在 .tours/ 目录中，专为 CodeTour 格式设计，而非临时性的 Markdown 笔记。
一个好的导览应针对特定读者讲述一个故事：
仅创建 .tour JSON 文件。不要在此技能范围内修改源代码。
在以下情况下使用此技能：
示例：
| 不使用代码导览的情况 | 使用 | | --- | --- | | 在聊天中一次性解释就足够了 | 直接回答 | | 用户想要散文式文档，而不是 .tour 产物 | documentation-lookup 或仓库文档编辑 | | 任务是实现或重构 | 执行实现工作 | | 任务是没有导览产物的广泛代码库入职 | codebase-onboarding |
在编写任何内容之前探索仓库：
在理解代码结构之前，不要开始编写步骤。
根据请求确定角色和深度。
| 请求形式 | 角色 | 建议深度 | | --- | --- | --- | | "入职"，"新成员" | new-joiner | 9-13 步 | | "快速导览"，"快速了解" | vibecoder | 5-8 步 | | "架构" | architect | 14-18 步 | | "导览此 PR" | pr-reviewer | 7-11 步 | | "为什么这个出错了" | rca-investigator | 7-11 步 | | "安全审查" | security-reviewer | 7-11 步 | | "解释此功能如何工作" | feature-explainer | 7-11 步 | | "调试此路径" | bug-fixer | 7-11 步 |
每个文件路径和行锚点必须是真实的：
切勿猜测行号。
.tour写入：
text.tours/<persona>-<focus>.tour
保持路径确定且可读。
在完成之前：
谨慎使用，通常仅用于结束步骤：
json{ "title": "Next Steps", "description": "You can now trace the request path end to end." }
不要将第一步设为纯内容。
用于引导读者了解模块：
json{ "directory": "src/services", "title": "Service Layer", "description": "The core orchestration logic lives here." }
这是默认步骤类型：
json{ "file": "src/auth/middleware.ts", "line": 42, "title": "Auth Gate", "description": "Every protected request passes here first." }
当某个代码块比整个文件更重要时使用：
json{ "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." }
当精确行号可能发生变化时使用：
json{ "file": "src/app.ts", "pattern": "export default class App", "title": "Application Entry" }
在需要时用于 PR、问题或文档：
json{ "uri": "https://github.com/org/repo/pull/456", "title": "The PR" }
每个描述应回答：
保持描述简洁、具体，并基于实际代码。
除非任务明确需要不同结构，否则使用此弧线：
导览应感觉像一条路径，而非清单。
json{ "$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." } ] }
| 反模式 | 修复 | | --- | --- | | 平铺直叙的文件列表 | 讲述一个步骤间有依赖关系的故事 | | 通用描述 | 指明具体的代码路径或模式 | | 猜测的锚点 | 先验证每个文件和行 | | 快速导览步骤过多 | 果断精简 | | 第一步是纯内容 | 将第一步锚定到真实文件或目录 | | 角色不匹配 | 为实际读者编写，而非通用工程师 |
codebase-onboardingcoding-standardscouncilmicrosoft/codetourOther measured skills in the registry, with their headline benchmark lift.