code-tour

原文涵盖的主题

• 代码导览
• 何时使用
• 何时不使用
• 工作流程
• 1. 探索
• 2. 推断读者
• 3. 读取并验证锚点
• 4. 编写 .tour

创建 CodeTour .tour 文件，用于代码库导览，可直接打开真实文件并定位到指定行范围。导览文件存放在 .tours/ 目录中，专为 CodeTour 格式设计，而非临时性的 Markdown 笔记。 一个好的导览应针对特定读者讲述一个故事： 他们正在查看什么 为什么重要 接下来应该遵循什么路径 仅创建 .tour JSON 文件。不要在此技能范围内修改源代码。 在以下情况下使用此技能： 用户请求代码导览、入职导览、架构导览或 PR 导览 用户说“解释 X 如何工作”，并希望获得可重用的引导式产物 用户希望为新工程师或审阅者提供上手路径 相比平铺直叙的摘要，引导式序列更适合该任务 示例： 新维护者入职 单个服务或包的架构导览 锚定到变更文件的 PR 审查导览 展示故障路径的根本原因分析导览 信任边界和关键检查的安全审查导览 | 不使用代码导览的情况 | 使用 | | --- | --- | | 在聊天中一次性解释就足够了 | 直接回答 | | 用户想要散文式文档，而不是 .tour 产物 | documentation-lookup 或仓库文档编辑 | | 任务是实现或重构 | 执行实现工作 | | 任务是没有导览产物的广泛代码库入职 | codebase-onboarding | 在编写任何内容之前探索仓库： README 和包/应用入口点 文件夹结构 相关配置文件 如果导览聚焦于 PR，则查看变更的文件 在理解代码结构之前，不要开始编写步骤。 根据请求确定角色和深度。 | 请求形式 | 角色 | 建议深度 | | --- | --- | --- | | "入职"，"新成员" | 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 步 | 每个文件路径和行锚点必须是真实的： 确认文件存在 确认行号在范围内 如果使用选区，验证确切的代码块 如果文件易变，优先使用基于模式的锚点 切勿猜测行号。 写入： 保持路径确定且可读。 在完成之前： 每个引用的路径都存在 每行或每个选区都有效 第一步锚定到真实文件或目录 导览讲述连贯的故事，而非罗列文件 谨慎使用，通常仅用于结束步骤： 不要将第一步设为纯内容。 用于引导读者了解模块： 这是默认步骤类型： 当某

这里只展示节选，请以完整原文和当前要求为准。