SuperAPI AI 工具集

human-gate

智能体与模型

查看项目

更新于 10-16 04:59

技能介绍

用途:human-gate 补足机器校验之外的人工环节。机器校验回答“检查是否通过”,human-gate 回答“是否有人看过、异议是否已解决”,并证明审核确实发生过。开始前需确定:产物是 .md 还是 .html、具名审核人是谁、工作是否可逆、当下是否有人可用;若存在 human-gate-context.md 应先阅读。

主要能力:构建单文件 HTML 审核页,不自行发起网络请求,并对被审核 HTML 做净化(移除 on*、javascript:、iframe);收集反馈为 batch.v1 格式;提供门禁判定。反馈落在 <artifact>.review.md,可由页面导出,也可手工编写。严重级别有 BLOCKER / MAJOR / MINOR / NIT,另有 NOTE、APPROVE 和 EDIT。

用法:脚本位于 engineering/human-gate/skills/human-gate/scripts。常用命令:python3 $S/human_gate.py open plan.md --launch(构建页面并开启新一轮,然后结束本轮)、status plan.md(非阻塞,返回 0 clear·2 blocked·3 collect·4 none)、collect plan.md --output json、close plan.md(退出码 2 表示未完成)。human_gate.py --sample 可在约 1 秒内跑完整循环。

门禁规则:无轮次被收集、存在未解决的 BLOCKER 或 MAJOR、无具名审核人、上次收集后 sidecar 被改动、轮次上限耗尽(升级而非放行)、使用豁免但未记录原因、轮次存在未解决的完整性问题时,均拒绝关闭。豁免需显式:close plan.md --waive "<原因>",但 G1 永不可豁免。

限制与硬性规则:close 退出 2 时绝不能报告完成;不得为满足 G3 编造审核人姓名;不得转述 EDIT 的 after 内容;不得阻塞式轮询等待人工;不得自动获取并运行未固定版本的代码,petergyang/human-review 为可选、需先询问且始终固定版本(npx -y human-review@0.6.0),其轮询会阻塞并原地改写 HTML,需加以包裹,且它只改变编辑器而不改变门禁;审核页只是查看界面,不是事实来源。连续两轮仅有 NIT 即视为完成。