用途
Walkthrough 用于与用户一起解释和检查一个确切的变更集。它一次呈现一个连贯的切片，并在继续之前等待用户做出决定。该技能适用于交互式讲解，也可在用户明确要求时用于由智能体呈现的自动化讲解。
主要能力
- 选择来源：确认以下来源之一——最近一次完成的变更、相对于 HEAD 的工作树、从已验证合并基到分支头部的分支、从已验证 base 与 head 提交的拉取请求。
- 报告范围外变更：对于所选范围之外的工作树变更会予以报告，不会静默纳入。
- 选择呈现者：常规交互式讲解使用主线程；当用户要求自动化智能体讲解时，读取呈现者指南并使用全新的只读呈现者。
- 构建变更地图：在构建变更地图之前先阅读呈现模式。检查所选 diff、变更文件、测试、文档和验证证据，构建一个有序地图，覆盖每一个变更文件。
- 按行为分组：按行为或契约对文件分组，而不是呈现文件转储。
- 呈现切片：呈现一个切片及其行为、决策、决定性证据、验证和风险。当呈现模式要求时，包含一个教训、一个具体示例和一个练习。
- 确认与暂停：提出一个聚焦的确认问题，并暂停等待用户回应。
- 记录纠正：记录有效的纠正但不实施。
- 重建切片：在单独授权的纠正改变了范围后，重建受影响的切片。
- 完成条件：仅当每个变更文件都被覆盖，且每个纠正都已解决或被明确推迟时才结束。
- 日志：仅在已知日志路径或用户要求持久化时，阅读 walkthrough 日志指南。在切片决策和纠正时更新日志，而不是每条消息都更新。
使用方式
该技能为只读，唯一例外是经授权的 walkthrough 日志。问题或纠正不授权进行代码修改、提交、推送或发布。使用时先确认一个来源，再选择呈现者，阅读呈现模式，然后进入讲解循环：检查证据、构建有序地图、按行为分组、逐切片呈现并提问、暂停等待回应、记录纠正、必要时重建切片，直至覆盖全部变更文件且纠正均已解决或明确推迟。
适用场景
- 需要向用户逐步解释最近一次变更、工作树、分支或拉取请求时。
- 需要以交互方式让用户对每个变更切片做出接受或纠正决定时。
- 需要由智能体自动呈现只读讲解时。
限制
- 除经授权的 walkthrough 日志外，该技能为只读。
- 问题或纠正不授权代码修改、提交、推送或发布。
- 不得将沉默、摘要、通过的测试、练习完成或呈现者的信心视为用户接受。
- 所选范围之外的工作树变更会被报告，不会静默纳入。
- 关于收费、价格、平台、具体安装命令等事实，资料中暂未提供。