用途:当用户要求创建代码导览、入职导览、架构走查、PR 导览、RCA 走查、安全审查或缺陷调查等结构化走查时,生成 CodeTour 的 .tour JSON 文件。文件保存在 .tours/<persona>-<focus>.tour,配合 VS Code CodeTour 扩展使用。只创建 .tour 文件,绝不修改源代码。
主要能力:先探索仓库(根目录、README、配置文件、语言与框架、目录结构、入口点),再静默推断角色、深度与焦点。角色包括 vibecoder、new-joiner、bug-fixer、rca-investigator、feature-explainer、pr-reviewer、architect、security-reviewer、refactorer、external-contributor;意图不明时默认 new-joiner 加 standard 深度。步骤类型有 Content(仅用于开头结尾,最多 2 个)、Directory、File+line、Selection、Pattern、URI。深度对应步数:quick 5-8、standard 9-13、deep 14-18。描述采用 SMIG 公式(情境、机制、含义、易错点)。
使用方式:每个文件路径与行号必须实际读取验证;路径相对仓库根目录,不带前导 / 或 ./;首步须有文件或目录锚点;若设置 nextTour 需与另一导览标题完全一致。仓库源文件少于 5 个时,无论角色都生成 quick 深度。
限制:不编造文件或行号,不存在的文件跳过;避免文件罗列式描述、泛泛描述、猜测行号、quick 深度步数过多、以回顾式结尾。官方文本未提供更多细节。