agentleFS
cafe3310cafe3310/public-agent-skills/skills/interactive-human-review/SKILL.md

interactive-human-review

Skill256 starsChanged 5 months agoApache-2.0View on GitHub

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

The file

Files
SKILL.md

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)**等多维度的变更细节与联系。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.