К основному содержанию
скилл CX Codex

human-gate-designer — скилл для Claude Code

Скилл human-gate-designer проектирует точки human-in-the-loop для DAG-воркфлоу: что показать человеку, как собрать обратную связь и куда её направить. Пригодится при добавлении approval-гейтов в агентные пайплайны.

MIT 141 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill human-gate-designer -a claude-code
Открыть на GitHub

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

Скилл решает, где в DAG нужен ручной контроль. Дерево решений из SKILL.md предлагает четыре триггера: необратимое действие (deploy, отправка письма, submit), user-facing результат (отчёт, сайт, pull request), остаток бюджета больше $0.50 и confidence ниже 0.7. Гейт ставят перед необратимым действием или после генерации, но до доставки.

Что показывать человеку — отдельная часть скилла. Контекст из одного-двух предложений о проделанной работе, выделенные решения агента, confidence, потраченный и оставшийся бюджет, остаток узлов. Три кнопки: Approve, Modify, Reject. Modify открывает текстовое поле, и этот текст вшивается в промпт повторного запуска узла.

Роутинг обратной связи разветвлённый. Approve продолжает DAG. Modify перезапускает узел с введённым фидбеком и снова показывает результат человеку. Reject может затронуть один узел, фазу целиком или остановить весь DAG с возвратом частичных результатов.

Анти-паттерны из README стоит держать в голове: не ставьте гейт после каждого узла и не ограничивайтесь бинарным Approve/Reject. Без опции Modify человек не сможет дать конкретную правку, а сырой JSON без контекста в гейте бесполезен. Скилл работает с файлами через Read, Write и Edit.

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

  • определить, в каких узлах DAG нужен гейт
  • спроектировать, что человек видит на экране проверки
  • встроить фидбек из Modify в промпт повторного запуска
  • развести approve, reject и modify по разным веткам DAG
  • не заставить человека одобрять каждый узел подряд

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

  • Спроектируй approval-гейт перед отправкой email в моём DAG
  • Где поставить ручной контроль в этом воркфлоу?
  • Как оформить окно проверки для узла с confidence 0.65?

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

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill human-gate-designer -a claude-code

2Вручную: положить файлы

~/.claude/skills/human-gate-designer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/human-gate-designer/

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

Вопросы о human-gate-designer

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

Выполните npx skills add curiositech/some_claude_skills --skill human-gate-designer -a claude-code. Скилл появится в ~/.claude/skills/human-gate-designer/SKILL.md.

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

Проектирует точки ручного контроля в DAG-воркфлоу: решает, где их ставить, что показывать человеку и как направить решение approve/reject/modify обратно в граф.

Чем это отличается от runtime-исполнения гейтов?

Скилл только проектирует гейты. Для исполнения в рантайме README отсылает к dag-runtime с Temporal signals — это другой инструмент.

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

SKILL.md · MIT
---
name: human-gate-designer
description: Designs human-in-the-loop review points for DAG workflows. Determines what to present to the human, how to collect feedback, and how to route approve/reject/modify decisions back into the DAG.
  Use when adding approval gates, designing review UX, or handling human feedback in agent workflows. Activate on "human review", "approval gate", "human-in-the-loop", "human gate", "approval workflow",
  "user review step". NOT for executing human gates at runtime (use dag-runtime with Temporal signals), general UX design, or chatbot conversation design.
allowed-tools: Read,Write,Edit
metadata:
  category: Design & Creative
  tags:
  - human
  - gate
  - designer
  - human-review
  - approval-gate
  pairs-with:
  - skill: task-decomposer
    reason: Task decomposition identifies which DAG nodes require human approval gates
  - skill: output-contract-enforcer
    reason: Human gate inputs and outputs need schema validation before routing decisions
  - skill: reactflow-expert
    reason: Human gates are visualized as interactive approval nodes in DAG dashboards
---

# Human Gate Designer

Designs human-in-the-loop review points in DAG workflows: what to present, how to collect feedback, how to route decisions back into the DAG.

---

## When to Use

✅ **Use for**:
- Deciding WHERE in a DAG to place human gates
- Designing WHAT the human sees at each gate
- Defining HOW feedback routes back (approve/reject/modify)
- Balancing automation speed with human oversight

❌ **NOT for**:
- Runtime execution of human gates (use `dag-runtime` + Temporal signals)
- General UI/UX design (use design skills)
- Chatbot conversation flow (different pattern)

---

## Gate Placement Decision Tree

```mermaid
flowchart TD
  A{Is the action irreversible?} -->|Yes| G1[Gate BEFORE the action]
  A -->|No| B{Is output user-facing?}
  B -->|Yes| G2[Gate AFTER generation, BEFORE delivery]
  B -->|No| C{Cost > $0.50 for remaining nodes?}
  C -->|Yes| G3[Gate at the cost threshold]
  C -->|No| D{Confidence score < 0.7?}
  D -->|Yes| G4[Gate on low-confidence outputs]
  D -->|No| N[No gate needed]
```

### Where to Place Gates

| Situation | Gate Position | Why |
|-----------|-------------|-----|
| Irreversible action (deploy, send email, submit) | Before the action | Can't undo |
| User-facing deliverable (report, website, PR) | After generation, before delivery | Quality check |
| High cost remaining (>$0.50) | Before expensive phase | Budget confirmation |
| Low confidence output (&lt;0.7) | After the uncertain node | Expert judgment needed |
| Ambiguous task decomposition | After planning, before execution | Validate the plan |
| First run of a new template DAG | After each phase | Build trust gradually |

---

## Gate Presentation Design

### What the Human Sees

```
┌──────────────────────────────────────────────────────┐
│  🔍 Human Review: [Node Name]                        │
│                                                      │
│  Context: [1-2 sentences: what happened so far]      │
│                                                      │
│  Output to Review:                                   │
│  ┌──────────────────────────────────────────────────┐│
│  │ [The node's output, formatted for readability]   ││
│  │ [Key decisions highlighted]                      ││
│  │ [Confidence: 0.82]                               ││
│  └──────────────────────────────────────────────────┘│
│                                                      │
│  Cost so far: $0.08 / $0.50 budget                  │
│  Remaining nodes: 4 (est. $0.12)                    │
│                                                      │
│  [✅ Approve]  [✏️ Modify]  [❌ Reject]              │
│                                                      │
│  If modifying, what should change?                   │
│  ┌──────────────────────────────────────────────────┐│
│  │ [text input for human feedback]                  ││
│  └──────────────────────────────────────────────────┘│
└──────────────────────────────────────────────────────┘
```

### Presentation Principles

1. **Show context, not just output**: The human needs to understand what the DAG has done so far, not just the current node's result.
2. **Highlight decisions**: Bold or annotate the choices the agent made. These are what the human is actually reviewing.
3. **Show confidence**: If the agent was uncertain, say so. Low-confidence outputs need more scrutiny.
4. **Show cost**: The human should know what they've spent and what's remaining.
5. **Make "Modify" easy**: A text input for feedback that gets injected into the retry prompt.

---

## Feedback Routing

```mermaid
flowchart TD
  H[Human decision] --> A{Decision?}
  A -->|Approve| C[Continue to next wave]
  A -->|Modify| M[Re-execute node with human feedback injected]
  M --> V[Validate modified output]
  V --> H
  A -->|Reject| R{Reject scope?}
  R -->|This node only| RN[Re-plan this node with different approach]
  RN --> H
  R -->|Entire phase| RP[Re-plan from last successful phase]
  RP --> H
  R -->|Abort DAG| AB[Stop execution, return partial results]
```

### Feedback Injection

When the human selects "Modify," their text becomes part of the re-execution prompt:

```
Original task: [same as before]
Previous output: [the output the human rejected]
Human feedback: "[the human's modification text]"

Revise your output to address the human's feedback.
Preserve the parts they didn't comment on.
```

---

## Anti-Patterns

### Gate After Every Node
**Wrong**: Requiring human approval after every single node.
**Right**: Gate only at irreversible actions, user-facing outputs, and low-confidence decisions. Most internal nodes need no gate.

### Binary Approve/Reject Only
**Wrong**: The human can only approve or reject, with no way to provide specific feedback.
**Right**: Always include a "Modify" option with a text input for targeted feedback.

### No Context in the Gate
**Wrong**: Showing the human a raw JSON output with no explanation.
**Right**: Show: what the DAG is doing, what happened so far, what this output means, what happens next if approved.

© curiositech · MIT · curiositech/some_claude_skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
human-gate Alireza Rezvani Плагин human-gate для Claude Code собирает отзыв человека в структурированный артефакт и блокирует закрытие задачи, пока остаются открытые блокеры. ★ 30 251звёзд репо 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звёзд репо graph Yeachan-Heo Скилл graph запускает многошаговые пайплайны как ориентированные графы и после сбоя продолжает работу по журналу с незавершённых узлов. CX Codex +1 285установок agent-tool-call.workflow tt-a1i Промпт agent-tool-call.workflow для создания диаграммы workflow-а, где AI-агент вызывает инструменты с проверкой у человека. CX Codex GP ChatGPT ★ 98 599звёзд репо airflow-hitl astronomer Скилл airflow-hitl для Claude Code собирает HITL-воркфлоу в Airflow: согласование, ввод формы и ветвление по выбору человека. DAG ждёт ответа из UI. CX Codex +1 1 000установок

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

Весь набор →
git-workflow-expert Скилл git-workflow-expert для git-операций: стратегии ветвления, разрешение конфликтов, rebase и продвинутые команды вроде bisect и reflog. Выручает, когда история запуталась или нужно вытащить потерянный коммит. CX Codex +1 143установок microservices-patterns Скилл microservices-patterns помогает выбирать границы микросервисов и способы связи между ними. Пригодится при разборе монолита или проектировании распределённой системы. CX Codex +1 142установок output-contract-enforcer Скилл output-contract-enforcer для Claude Code проверяет JSON-выход узлов DAG по схеме и выявляет несовместимость соседних узлов. Помогает найти причину неожиданных данных в следующем узле. CX Codex +1 141установок anthropic-technical-deep-dive Скилл anthropic-technical-deep-dive готовит к техническим интервью в Anthropic: Constitutional AI, RLHF, интерпретируемость, скейлинг-законы, MCP, агентные системы и безопасность ИИ. CX Codex +1 141установок error-handling-patterns Скилл error-handling-patterns для Claude Code проектирует обработку ошибок в TypeScript и Python: помогает выбрать между исключениями и Result-типами и построить recovery-флоу. CX Codex +1 140установок dependency-management Скилл dependency-management помогает выбирать, фиксировать и проверять сторонние библиотеки в кодовой базе. Направляет аудит уязвимостей и настройку обновлений. CX Codex +1 140установок component-template-generator Скилл component-template-generator для Claude Code создаёт шаблоны компонентов React, Vue и Svelte с дизайн-токенами. Он включается при разработке библиотеки компонентов или переносе дизайн-системы в код. CX Codex +1 139установок recursive-synthesis Скилл recursive-synthesis оркестрирует мультиагентный синтез документов через 6 фаз: от расходящихся позиций до финального документа. Подходит для конституций, хартий и архитектурных решений. CX Codex +1 138установок

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

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