human-review

人工审查

让工作内容足够清晰，使人能够独立检查。 减少记忆上下文、查找证据和关联变更所需的精力， 让人能够专注于理解和判断。

重新了解工作

阅读请求、适用的项目决策、规范（如有）、当前差异 以及可用的审查记录。明确这项工作旨在实现什么，以及 人实际敲定了哪些选择。代码展示了实现内容，但不能证明人 有意接受了每一项后果。

开篇说明目的、变更结果以及从哪里开始查看。 如果有先前的审查上下文，指出自人上次检查的修订以来发生了哪些变化。 否则，说明一个全新的切入点。只根据对话推断对方的熟悉程度， 并根据对方提出的问题或表现出的知识盲区调整说明深度。

在压缩变更说明之前，逐项梳理每种行为变化、访问规则、 数据影响、外部交互和故障路径。对每一项，区分需要解释的内容、 需要产品决策的事项，以及已确认的缺陷；另行记录哪些内容是实际观察到的、 从源代码推断出的，或尚未验证的。这样可以避免简洁的说明悄然遗漏 变更的一部分。保留完整清单以供查阅，并在开篇附近列出阻塞事项和影响重大的未知情况。

展示行为如何变化

每次说明一种连贯的行为，将其触发条件、变更前后的结果、实现机制和后果联系起来。 让它在整个变更中的位置始终清晰，并让人能够选择查看其他部分， 包括 AI 认为已经敲定的选择。按发生的事情组织内容，而非按文件或实现层次组织。

采用最精简且便于检查关联的呈现方式： 实际 UI 截图、请求／响应值、简短的源代码对比、访问权限表或流程图。 将相关证据放在论述旁边，或放入相邻的可展开区域。 在有助于人检查结果如何得出的地方解释技术细节；更深入的源代码按需提供。

检查实际产品，并运行支持说明所需的最小安全检查。将每项观察到的结果关联到 明确标注的修订版本或未提交差异、路由或命令以及环境。注明提供的观察结果来自何处， 并保留其来源信息。先前 AI 总结只是陈述，不是证据。准确标注源代码推断出的结论和缺失的观察结果； 模拟界面或拟议界面绝不能说成是实际观察到的结果。审查准备过程中应对机密信息和个人数据进行脱敏， 并确保产品保持原样。

使用人的语言，描述具体操作和结果。说清楚实际问题、变更后的行为或查看证据的位置， 不要使用“未解决的承诺”“审查处置”或“证据路径”之类抽象的流程标签。 保留必要的技术名称，并结合上下文解释不熟悉的术语。省略无助于检查行为的时间估算、 严重性代码、评分，以及文件或测试数量。

支持判断，而非代替判断

在影响重大的假设或边界处邀请对方审视，而不是每次解释后都请求确认。问题应揭示真实的选择，以及每种回答会带来什么变化。不要因为缺少证据、差异很大，或需要修复已确认的缺陷，就擅自做出产品决策。

同时保持待定的产品决策最多为三个，并明确列出每项延期的决策，以便先前的决策确定后再处理。优先从后果代价高或难以撤销的选择开始。此限制针对决策，而非人类可以检查的工作。没有待定的产品决策时，仍要解释行为并提供相关证据；另行说明缺陷或缺失的观察是否妨碍就绪声明。

只有在人类在对话中明确表态时，才将选择视为已确定。打开某个部分、阅读、沉默和一般性确认都不代表接受。通过项目现有的决策流程保留已确认且可复用的决策；临时审查页面和笔记不属于正式记录。

留下可用的续接点

审查暂停或人类切换任务时，在对话中留下简洁的说明；如果便于移交，也可将说明放在临时审查材料旁。注明源代码版本和任何未提交的更改；如果未提交的编辑属于该源代码，保留相关差异或快照。记录实际检查过的部分、人类明确表达的决策或问题、仍待处理的事项，以及下一步有用的行动。附上说明及其源证据的链接，方便其他会话接手。将观察到的导航行为与明确表达的理解和接受分开记录；如果没有相关信息，请如实说明。

恢复工作时，先将当前工作与记录的源代码进行比较，再决定是否沿用先前的观察。指出哪些内容需要重新检查以及原因，保留不受影响的讨论，并从未解决的问题继续。如果无法恢复先前的源代码，请说明哪些比较无法进行，而不是声称审查结果仍然有效。移交任何审查前，请提供一个后续起点，不要假装人类已经检查过该内容。

提供人类可用的审查材料

简单说明留在对话中。当比较、导航或持续审查需要 HTML 帮助时，在仓库之外改编 assets/review.html。该模板提供上下文、行为概览、前后对比、附近证据和可选的续接说明。翻译标签、替换占位符并删除未使用的部分；模板只是起点，并非每项更改都必须呈现的界面。

对于 HTML，请在浏览器中检查导航、对比、折叠内容和窄视口。修复内容不完整或控件失效的问题后，再将界面称为就绪。如果无法进行浏览器验证，请说明这一限制。使用当前测试环境支持的方法运行完成后的 HTML，并提供用户可以打开的地址；如果支持预览，也一并提供。让服务器保持运行，以便审查。浏览器验证只能证明审查界面可用，不能证明底层产品正确或已获批准。

成功的移交应有助于解释行为、检查 AI 未标出的假设，并在切换任务后继续审查。不要仅因页面能够渲染或人类表示批准，就声称人类理解有所提升。