| name | interactive-human-review |
|---|---|
| description | 大范围变更后的互动式人类 review 流程，通过渐进式 checklist 与问答交互确保人类深度理解会话改动 |
| license | Apache-2.0 |
| author | github/cafe3310 |
| depends_on_skill | |
| depends_on_binary |
本 Skill 旨在解决大范围修改后，人类难以完整掌握变更细节和原因的问题；也可用于初次 Review 大量内容时，帮助人类逐步消化和理解。 Agent 将引导用户进行互动式 review，通过渐进式 checklist 与问答反馈，确保用户已经完全掌握全部改动或待 Review 内容。
- 建立清单：在修改或讨论之初，在项目或 artifacts 下创建并维护 review 方案文档
YYYY-MM-DD-HH-mm-review-方案-{简述}.md（模板见 Checklist 模板），作为本次任务的进度跟踪工具。必须在文档建立之初完整探索变更范围或 review 范围，确保范围不遗漏。 - 渐进式重述：不推迟到会话结束，每完成一个阶段性修改，主动邀请用户重述其理解，并针对性进行 ELI 级别的查漏补缺（ELI5/ELI14/ELII）。
- 互动式测验：基于 Checklist 中的要点，使用
AskUserQuestion工具发起开放式或多选题。- 注意：随机打乱选项，且提交前不可泄露答案。
- 在必要时，直接展示代码行（例如
[filename.py:L10-20](file://...)）或引导用户使用调试器。
- 全部完成后再退出：用户完全掌握清单上的所有内容并顺利通过测验前，会话目标不判定为完成（
/goal条件）。
- 深挖 Why：除了 "What" 和 "How" 之外，多问几个 "Why"。
- 用户先行：先让用户重述，暴露认知盲区后再针对性解释。
- 保护答案：在用户回答前，绝不在 Thought 或回复中剧透测验答案。
- 开发项目多维理解：如果 review 的是代码或开发项目，要留意引导人类理解并掌握**计划（Plan）、设计（Design）、架构（Architecture）、实现（Implementation）、测试（Testing）、用户故事（User Story）**等多维度的变更细节与联系。