# Interactive Human Review

> 大范围变更后的互动式人类 review 流程，通过渐进式 checklist 与问答交互确保人类深度理解会话改动

- Skill: `gabrielmoreira/interactive-human-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/interactive-human-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/interactive-human-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/interactive-human-review

---


# Skill: interactive-human-review

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

## 2. 工作流
1. **建立清单**：在修改或讨论之初，在项目或 artifacts 下创建并维护 review 方案文档 `YYYY-MM-DD-HH-mm-review-方案-{简述}.md`（模板见 [Checklist 模板](resources/understanding_checklist_template.md)），作为本次任务的进度跟踪工具。必须在文档建立之初完整探索变更范围或 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）**等多维度的变更细节与联系。