interactive-human-review

name	interactive-human-review
description	大范围变更后的互动式人类 review 流程，通过渐进式 checklist 与问答交互确保人类深度理解会话改动
license	Apache-2.0
author	github/cafe3310
depends_on_skill	[]
depends_on_binary	[]

Skill: interactive-human-review

1. 概述

本 Skill 旨在解决大范围修改后，人类难以完整掌握变更细节和原因的问题；也可用于初次 Review 大量内容时，帮助人类逐步消化和理解。 Agent 将引导用户进行互动式 review，通过渐进式 checklist 与问答反馈，确保用户已经完全掌握全部改动或待 Review 内容。

2. 工作流

1. 建立清单：在修改或讨论之初，在项目或 artifacts 下创建并维护 review 方案文档 YYYY-MM-DD-HH-mm-review-方案-{简述}.md（模板见 Checklist 模板），作为本次任务的进度跟踪工具。必须在文档建立之初完整探索变更范围或 review 范围，确保范围不遗漏。
2. 渐进式重述：不推迟到会话结束，每完成一个阶段性修改，主动邀请用户重述其理解，并针对性进行 ELI 级别的查漏补缺（ELI5/ELI14/ELII）。
3. 互动式测验：基于 Checklist 中的要点，使用 AskUserQuestion 工具发起开放式或多选题。
   • 注意：随机打乱选项，且提交前不可泄露答案。
   • 在必要时，直接展示代码行（例如 [filename.py:L10-20](file://...)）或引导用户使用调试器。
4. 全部完成后再退出：用户完全掌握清单上的所有内容并顺利通过测验前，会话目标不判定为完成（/goal 条件）。

3. 基本原则

• 深挖 Why：除了 "What" 和 "How" 之外，多问几个 "Why"。
• 用户先行：先让用户重述，暴露认知盲区后再针对性解释。
• 保护答案：在用户回答前，绝不在 Thought 或回复中剧透测验答案。
• 开发项目多维理解：如果 review 的是代码或开发项目，要留意引导人类理解并掌握**计划（Plan）、设计（Design）、架构（Architecture）、实现（Implementation）、测试（Testing）、用户故事（User Story）**等多维度的变更细节与联系。