К основному содержанию
плагин

human-gate — плагин для Claude Code: гейт человеческой проверки артефактов

Плагин human-gate для Claude Code собирает отзыв человека в структурированный артефакт и блокирует закрытие задачи, пока остаются открытые блокеры.

MIT ★ 30 251 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add alirezarezvani/claude-skills
/plugin install human-gate@claude-code-skills
Открыть на GitHub

Что делает human-gate

human-gate добавляет в Claude Code отдельную полосу проверки человеком. Машинные проверки отвечают на вопрос «прошли ли тесты», а этот плагин — посмотрел ли кто-то на результат и сняты ли возражения. Плагин собирает фидбек как артефакт batch.v1, а не как сообщение в чате: каждый комментарий привязан к блоку, имеет уровень серьёзности и поддаётся учёту.

Работает так: open собирает одностраничную HTML-страницу ревью из Markdown или HTML-артефакта, collect забирает фидбек из sidecar-файла, close проверяет гейт и либо закрывает раунд, либо называет, что ещё открыто. Страница ревью делает ноль сетевых запросов: без CDN, шрифтов и серверов, открывается через file://. Проверяемый HTML санитизируется — on*-обработчики, javascript:-URL и iframe выбрасываются.

Серьёзности — BLOCKER, MAJOR, MINOR, NIT плюс EDIT, NOTE и APPROVE. Опечатка в ## BLOKCER тихо понижает уровень до NIT, поэтому гейт отказывается закрываться при неразрешённых проблемах целостности. Без Python плагин не запустится: это stdlib-only, но сам интерпретатор нужен.

Какие задачи решает

  • собрать страницу ревью из Markdown или HTML одним файлом
  • превратить разрозненный фидбек в структурированный batch.v1
  • отказать в закрытии раунда при открытом BLOCKER или MAJOR
  • не дать агенту продолжить без названного ревьюера
  • сработать в CI и по SSH, где нет браузера

Примеры запросов агенту

  • Открой раунд ревью для plan.md и передай путь ревьюеру.
  • Собери фидбек из sidecar и примени все пункты batch.v1.
  • Проверь статус гейта для plan.md, прежде чем продолжать работу.

Как установить human-gate

Через маркетплейс плагинов

/plugin marketplace add alirezarezvani/claude-skills
/plugin install human-gate@claude-code-skills

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о human-gate

Как установить human-gate в Claude Code?

Выполни /plugin marketplace add alirezarezvani/claude-skills, затем /plugin install human-gate@claude-code-skills.

Что делает human-gate?

Строит HTML-страницу ревью для Markdown или HTML-артефакта, собирает фидбек ревьюера как структурированный batch.v1 и управляет гейтом: отказывается закрывать раунд, пока открыты блокеры, ревьюер не назван или sidecar изменился после сбора.

Почему нет локального HTTP-сервера?

Автор сознательно не добавлял сервер: страница на file:// плюс sidecar покрывают цикл ревью без слушающего сокета, схемы токенов и фонового процесса.

Исходный текст

human-gate · MIT
# human-gate

**The human-verification lane for an agent loop.**

Machine checks answer *"do the tests pass?"*. This answers the other question:
**has a person actually looked at this, and are their objections resolved?**

```sh
S=engineering/human-gate/skills/human-gate/scripts
python3 $S/human_gate.py --sample     # the whole loop, refusals included, in ~1s
```

---

## Why

Human feedback usually arrives as chat prose:

> Change the third paragraph, cut the second card, rewrite the CTA, and the table numbers
> look stale.

Four instructions in one blob. Nothing enumerates them, so nothing detects a miss.
"The third paragraph" drifts as the document changes. Severity is invisible — a wrong
number and a style preference look identical. And round 2 cannot tell what round 1 asked
for.

**human-gate makes feedback an artifact instead of a message:** anchored to blocks,
severity-graded, countable, diffable — and read by a gate that either passes or names
exactly what is still open.

## The loop

```sh
python3 $S/human_gate.py open plan.md --launch   # build review page, start round N
                                                  # → hand over path, END YOUR TURN
python3 $S/human_gate.py status plan.md           # non-blocking: 0 clear · 2 blocked · 3 collect · 4 none
python3 $S/human_gate.py collect plan.md --output json   # batch.v1 — apply every item
python3 $S/human_gate.py close plan.md            # exit 2 = you are NOT done
```

## What's inside

| File | Purpose |
|---|---|
| `scripts/review_page_builder.py` | Markdown/HTML → single-file review page, every block anchored. The page itself makes **zero network requests** — no CDN, no fonts, no server, no socket; ~11 KB, opens over `file://`. Reviewed HTML is sanitized first: `on*` handlers, `javascript:` URLs (including control-character-smuggled ones), `xlink:href`, `srcdoc`/`srcset`, inline `style` (a `background-image:url(...)` beacons on open), and `iframe`/`object`/`embed`/`base` are dropped, so a draft cannot execute inside the page. A reviewed HTML artifact's own `https:` images still load, as they must for the review to be faithful, and so do protocol-relative (`//host/x`) URLs — neither can execute. Both allowances are pinned by `--sample` assertions, not just by prose. |
| `scripts/feedback_parser.py` | Review sidecar → `batch.v1` JSON, with quote verification against the real file. |
| `scripts/human_gate.py` | State machine + the gate. `open`/`status`/`collect`/`close`/`reset`. |
| `references/human_in_the_loop_canon.md` | Bainbridge, Fagan, Wiegers, Weinberg, Google SWE ch.9, Klein pre-mortem. |
| `references/feedback_batching.md` | W3C Web Annotation selectors, Conventional Comments, GitHub batched-review model. |
| `references/review_loop_discipline.md` | Why there is no blocking poll, why rounds are capped, why exhaustion escalates. |
| `assets/batch.v1.schema.json` | The feedback batch contract. |
| `assets/example_review_sidecar.md` | Worked example of the hand-writable sidecar. |

Stdlib-only Python. No dependencies, no build step.

## The sidecar is hand-writable — on purpose

The review page exports it, but any reviewer with an editor can write it directly. That
is what keeps the loop working over SSH and in CI, where no browser exists:

```markdown
# Review feedback: plan.md
<!-- human-gate:v1 target=plan.md round=1 -->

reviewer: reza

## BLOCKER b2
> We expect a 40% lift in activation.
No source for 40%, and it drives the whole plan. Cite it or cut it.

## EDIT b7
- before: The team will endeavour to deliver incremental value
+ after: The team ships one usable slice per week

## NOTE
Structure is right. Fix the blocker and this is good to go.
```

Severities are **BLOCKER / MAJOR / MINOR / NIT** — the same ladder
`markdown-html/md-review` uses, from Google's *Code Review Developer Guide*. Plus **EDIT**
(a verbatim replacement), **NOTE** (unanchored), **APPROVE** (explicit sign-off).

## The gate

| Rule | Refuses to close when |
|---|---|
| **G1** | no review round collected — nobody has looked |
| **G2** | a BLOCKER or MAJOR is still open |
| **G3** | no named reviewer — approval belongs to a person |
| **G4** | the sidecar changed after the last collect |
| **G5** | round cap exhausted → **escalate**, never pass |
| **G6** | a waiver is used without a recorded reason — and **G1 is never waivable** |
| **G7** | the round carries unresolved integrity problems — a mistyped severity (`## BLOKCER`) silently downgrades to NIT, an EDIT has no replacement text, or a quote is in neither the raw source nor its rendered text |

Overrides are legitimate and must be explicit:

```sh
python3 $S/human_gate.py close plan.md --waive "reviewer on leave; CTO accepted risk in writing"
```

The reason and every refusal it overrode are stored in gate state. **`--waive` cannot
override G1**: it accepts objections a reviewer raised, it cannot manufacture a review that
never happened — otherwise the whole gate would be one flag away from opt-out.

## Loop discipline

There is deliberately **no blocking poll**. `status` returns immediately.

- Open a round, hand over the path, **end the turn**. State lives in `.human-gate/`.
- **Headless guard** — on CI, SSH, or no `DISPLAY`, `open` says so and skips the browser.
- **Round cap** (`--max-rounds`, default 5). Exhaustion exits **5 = ESCALATE**, not 0.
  `open` records the cap in gate state and every later command inherits it, so
  escalation can't drift with how a command happened to be typed; passing the flag
  again renegotiates the cap and says so.
- **`status` previews the whole gate** — it shares `gate_refusals()` with `close`, so the two
  can never disagree about whether the work is done.

Reasoning in `references/review_loop_discipline.md`.

## Design notes

Two things this plugin deliberately does **not** ship, and why:

- **No local HTTP server.** A file:// page plus a sidecar covers the review loop without
  a listening socket, a token scheme, or a background process to reason about.
- **No rich block-drag / image-paste editor.** That is genuinely nice and genuinely
  expensive — it is the bulk of upstream's ~5,200 LOC. If a reviewer wants it, the
  optional pinned bridge in `SKILL.md` hands off to upstream, and the gate still governs
  closure.

## Related

- **`engineering/agent-harness`** — machine verification and loop control. This is the
  human lane it lacks. Pair them.
- **`markdown-html/md-review`** — renders a code review *to* HTML, one-way. Use when
  *you* are the reviewer; use human-gate when someone else is.
- **`engineering/grill-me`** — interrogates a plan in conversation, before an artifact exists.
- **`marketing-skill/content-humanizer`**, **`engineering/behuman`** — make AI text sound
  human. Different problem: this is human *approval*, not human *voice*.

## Attribution

The batched-review pattern derives from
[`petergyang/human-review`](https://github.com/petergyang/human-review) (MIT © 2026 Peter
Yang). **No upstream code is used** — this is a conceptual derivation with a deliberately
different design (stdlib Python instead of Node, no server, no network fetch, non-blocking
loop with a round cap, plus a closing gate upstream does not have).

The audit that drove those choices — including running upstream's own test suite
(**90/90 passing**) — is at
[`audit/human-review-2026-08/AUDIT.md`](../../audit/human-review-2026-08/AUDIT.md).

© Alireza Rezvani · MIT · alirezarezvani/claude-skills

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
human-gate-designer curiositech Скилл human-gate-designer проектирует точки human-in-the-loop для DAG-воркфлоу: что показать человеку, как собрать обратную связь и куда её направить. Пригодится при добавлении approval-гейтов в агентные пайплайны. CX Codex +1 141установок messaging-the-human mvschwarz Скилл messaging-the-human для агента: найти нужного человека в проекте, проверить канал и отправить короткий бриф с решением или апдейтом через CLI rig. CX Codex +1 ★ 8 928звёзд репо Human For AI humanforai MCP-сервер Human For AI отдаёт задачи, которые не решить в коде: проверить место или цену, протестировать приложение, оценить текст. Оператор отвечает в течение 12 часов. CX Codex +1 ★ 1звёзд репо loop-architect https://ft.ia.br Скилл loop-architect проектирует агент-луп с проверкой по best practice и кросс-модельными воротами рецензирования. Помогает, если нужно построить итеративный рабочий процесс, self-review луп, LLM-as-judge или многомодельный совет. CX Codex +1 ★ 141звёзд репо verification-gate sentimony Скилл verification-gate не даёт объявить работу законченной без свежих доказательств: собирает матрицу проверок и выносит вердикт по конкретному набору утверждений. CX Codex +1 2 600установок agent-acceptance-gate WenyuChiou Скилл agent-acceptance-gate для Claude Code сверяет результаты дорожек перед коммитом или пушем и выносит вердикт. CX Codex +1 ★ 34звёзд репо

Из того же набора488

Весь набор →
deep-learning-book Плагин deep-learning-book для Claude Code разбирает двадцать глав учебника Deep Learning и проверяет, что в них изменилось с 2016 года. ★ 30 251звёзд репо spinning-up-deep-rl Плагин spinning-up-deep-rl для Claude Code даёт справочные материалы по глубокому обучению с подкреплением. Он помогает разбирать алгоритмы и отлаживать RL-код. ★ 30 251звёзд репо agent-memory Плагин agent-memory для Claude Code переносит повторяющиеся факты в долговременный контекст после ручного подтверждения. ★ 30 251звёзд репо agent-launcher-skills Плагин agent-launcher-skills для Claude Code собирает Claude Managed Agents по цели, запускает оценку с итерациями или планирует повторные запуски. Работает с агентами в аккаунте Anthropic. ★ 30 251звёзд репо collab-proof Плагин collab-proof для Claude Code проводит ретроспективу сессии кодинга и разделяет вклад разработчика и Claude. Ретроспектива помогает фиксировать авторство решений и разбирать совместную работу. ★ 30 251звёзд репо compliance-team-iso42001 Плагин compliance-team-iso42001 для Claude Code помогает проверять систему управления ИИ по ISO/IEC 42001:2023. Он анализирует пробелы, собирает реестр рисков и планирует внутренние аудиты. ★ 30 251звёзд репо compliance-team-eu-ai-act Плагин compliance-team-eu-ai-act для Claude Code классифицирует ИИ-системы по EU AI Act, планирует оценку соответствия и формирует матрицу обязанностей. ★ 30 251звёзд репо video-content-strategist Плагин video-content-strategist для Claude Code помогает планировать видеостратегию, писать сценарии роликов и оптимизировать каналы на YouTube. Также помогает выстраивать пайплайны Shorts, Reels и TikTok. ★ 30 251звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой