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