RPI Walkthrough 用于逐段引导用户理解一个目标对象:源代码、UI 或 UX 接线、库或功能、提示工程制品(prompt、instructions、agent、skill),或 .copilot-tracking 制品(research、plan、changes、review、log 文档)。完整协议、分段循环、引用表格式、决策与变更台账格式及深度审查见 references/walkthrough.md,并遵循 copilot-tracking.instructions.md 的共享约定。
主要能力:先用可用的搜索与读取工具对目标做深度审查,必要时以子代理处理大范围追踪;当解释依赖外部库、框架或标准时,激活 rpi-research 并先读取其主制品。然后在对话中规划连贯分段,逐段解释每段做什么、如何连接、为何如此,配以行内 Markdown 链接和引用表。目标有有意义结构或流程时,在第一段前渲染概览 Mermaid 图。
使用方式:从显式输入、附件或打开文件、对话上下文中解析目标与详细程度,detail 可选 brief、normal、deep,默认 normal,会话中可更改。若无法形成目标则停下询问;多个不相关目标时让用户选择。每段以 ### Segment N: 标题开头,每轮最多提一两个问题,暂停等待用户指示。仅当出现实质性用户决策或变更请求时,才按模板创建 .copilot-tracking/walkthroughs/{{YYYY-MM-DD}}/{{task_slug}}-decisions.md 并追加条目。
限制:默认只读,不修改源文件,除非用户明确要求立即变更且变更范围安全。不持久化分段覆盖、完成状态或恢复数据。无法访问先前对话上下文时,不依据台账重建进度,而是询问目标和起点。资料未提供具体安装、收费或平台信息。