Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

human-gate-designer

/human-gate-designer

Projektuje punkty przeglądu człowieka w przepływach DAG: co pokazać człowiekowi, jak zebrać informację zwrotną i jak przekierować decyzję zatwierdź, odrzuć lub zmień do grafu.

Repozytorium
windags-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Projektuje punkty przeglądu człowieka w przepływach DAG: co pokazać człowiekowi, jak zebrać informację zwrotną i jak przekierować decyzję zatwierdź, odrzuć lub zmień do grafu.

Wyzwalacze z opisu

human reviewapproval gatehuman-in-the-loophuman gateapproval workflowuser review step
Oryginalny opis (EN)

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.

Jak działa

  1. When to Use
  2. Gate Placement Decision Tree
  3. Gate Presentation Design
  4. Feedback Routing
  5. Anti-Patterns
  6. Output Contract
Sekcje z nagłówków SKILL.md, w oryginale · 143 linii, 727 słów
Podgląd SKILL.md
---
name: human-gate-designer
license: Apache-2.0
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
category: Agent & Orchestration
tags:
  - human-in-the-loop
  - approval-gates
  - safety
  - oversight
  - workflow
---

# 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.


## Output Contract

This skill produces:
- **Skill/agent definition files** following the standard skill format
- **Configuration manifest** with metadata, tool permissions, and activation triggers
- **Integration tests** validating skill behavior against expected outputs
- **Documentation** with usage examples and activation patterns

Wersje

RepozytoriumWynikLicencja
Ta strona · curiositech/windags-skills100Apache-2.0
curiositech/some_claude_skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki b8cc776e031a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100human-in-the-loop-designer
    Projektuje procesy z udziałem człowieka dla systemów AI: kolejki przeglądu, wyzwalacze eskalacji, pętle zwrotne i bramki zatwierdzania z limitem czasu na reakcję.
  • 90human-in-the-loop
    Pomaga projektować bramki zatwierdzania przez człowieka dla ryzykownych akcji agentów: punkty kontrolne, potwierdzenia, poziomy ryzyka i przegląd akcji.
  • 100quality-gate-designer
    Zamienia łańcuchy zatwierdzeń przez ludzi w automatyczne bramki jakości z jawnymi kryteriami i walidacją scenariuszami wstrzymanymi, rozkładając każdy krok według funkcji: jakość, ryzyko, polityka, zgodność.
  • 100human-in-the-loop
    Projektuje, gdzie, kiedy i jak człowiek zatwierdza, sprawdza lub ratuje agenta LLM: bramki zatwierdzeń, eskalacje, kolejki przeglądu i nadzór dla działań nieodwracalnych oraz regulowanych procesów.
  • 100independent-approval-review
    Przegląda chroniony zapis lub decyzję jako niezależna sesja, która go nie pisała, i zatwierdza, gdy nie widzi powodu do odrzucenia.
  • 100human-in-the-loop
    Projektuje etapy zatwierdzania przez człowieka w automatyzacji: kto sprawdza wyniki AI, ile ma czasu i jak uniknąć formalności.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.