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

clarify

/clarify

Przeprowadza ograniczone doprecyzowanie przed sfinalizowaniem planu fazowego, gdy zostają nierozwiązane znaczniki [?] lub niejednoznaczności zmieniające plan.

Repozytorium
agents ↗
Licencja
MIT
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

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przeprowadza ograniczone doprecyzowanie przed sfinalizowaniem planu fazowego, gdy zostają nierozwiązane znaczniki [?] lub niejednoznaczności zmieniające plan.

Wyzwalacze z opisu

use clarify modeclarifyclarify the planresolve ambiguityclarifying questions
Oryginalny opis (EN)

Bounded clarification/refinement pass for planning. Use before finalizing a phased plan when unresolved [?] markers or plan-changing ambiguity remain. Triggers on: 'use clarify mode', 'clarify', 'clarify the plan', 'resolve ambiguity', 'clarifying questions'.

Jak działa

  1. When to run
  2. Two delivery modes
  3. Ambiguity scan
  4. How to run the pass
  5. Open clarifying questions block format (subagent mode)
  6. Recording format (task.md)
Sekcje z nagłówków SKILL.md, w oryginale · 79 linii, 476 słów
Podgląd SKILL.md
---
name: clarify
description: "Bounded clarification/refinement pass for planning. Use before finalizing a phased plan when unresolved [?] markers or plan-changing ambiguity remain. Triggers on: 'use clarify mode', 'clarify', 'clarify the plan', 'resolve ambiguity', 'clarifying questions'."
---

# Clarify Mode — Bounded Refinement Pass

Run this pass **before finalizing the phased plan** (Step 6) to resolve plan-changing
ambiguity. Work high-level → detailed. This is the single sanctioned place to raise
questions — bounded, not a gate.

## When to run

Run the ambiguity scan for any task that will produce a **multi-phase plan**. This is the
default for multi-phase work — the scan is a silent mental pass, not a ceremony.

**Quick-exit:** Skip for single-phase / trivially-scoped tasks where scope is self-evident
(e.g., "fix this typo", "bump version to X", "rename Y to Z").

The ≤5 cap is a ceiling, never a target. Fewer is better.

## Two delivery modes

**Determine which mode you are in before proceeding:**

- **Subagent (spawned by the Conductor or another agent):** you CANNOT prompt the user
  directly. Return your plan draft and append an `## Open clarifying questions` block
  (format below). Do NOT try to ask interactively.
- **Direct invocation (user ran you directly):** ask the user via conversational turns,
  one question at a time where an answer informs the next.
- **If unsure which mode you are in, assume subagent and return questions.**

## Ambiguity scan

Before collecting `[?]` markers, silently scan the task against these common ambiguity
patterns. Only surface items where the answer isn't determinable from the user's prompt
or the codebase:

- **Scope boundaries** — what's in, what's explicitly out?
- **Backward compatibility** — does this change behavior for existing consumers?
- **Error/edge-case strategy** — fail loudly or degrade gracefully?
- **Approach choice** — multiple valid approaches exist; has one been decided?
- **Implicit dependencies** — ordering or environment assumptions not stated?

If the scan surfaces nothing, proceed to phasing without asking questions. Do not report
"scan clean" — just move on.

## How to run the pass

1. Collect plan-changing ambiguities — prefer existing `[?]` markers over new ones.
2. Ask ≤5 targeted questions, highest-impact first.
3. Where an answer to one question informs another, ask one at a time (in sequence).
   Batch only mutually independent questions.
4. Stop early once unambiguous — never force 5 questions.
5. Record each answer and clear the matching `[?]` marker.
6. Finalize and save.

## `## Open clarifying questions` block format (subagent mode)

Append this block to your return after the plan draft:

```
## Open clarifying questions
1. [highest-impact question] — affects: [what part of the plan]
2. [next question, if independent of #1]
```

## Recording format (`task.md`)

Add a dated `## Clarifications` subsection under **Research Findings** before the phase
table is finalized:

```
## Clarifications

### YYYY-MM-DD
- Q: [question] → A: [user's answer]
- Q: [deferred question] → Assumed: [assumption made], no answer given
```

For deferred or unanswered items, record the assumption explicitly. Never silently
guess a plan-changing ambiguity — record it so the Builder and Reviewer can see it.

Wersje

RepozytoriumWynikLicencja
Ta strona · mcouthon/agents100MIT
ericrisco/rsc-harness100MIT
growupanand/ConvoForm100Apache-2.0
ramboz/jig100MIT
ramboz/jig100MIT
ramboz/jig100MIT
umputun/cc-thingz100MIT
ronakrupani/clarify100MIT
andreibesleaga/gabbe100CC-BY-4.0

Migawka bazy z 13.11.2026 · wersja paczki c94a34bde1d4 (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

  • 90sdlc-clarify
    Zadaje najwyżej pięć pytań, żeby wyjaśnić otwarte kwestie w szkicu specyfikacji, i zapisuje odpowiedzi z powrotem do dokumentu.
  • 95clarification-phase
    Prowadzi fazę /clarify z użyciem AskUserQuestion: rozwiązuje niejasności w spec.md przez uporządkowane pytania (maksymalnie 3), priorytetyzację i włączanie odpowiedzi, przed planowaniem.
  • 100clarify-task
    Rozstrzyga niejednoznaczności, doprecyzowuje niejasne kryteria i uwidacznia ukryte założenia w zadaniu, między create-task a plan-task w przepływie od tworzenia do wysyłki.
  • 100clarify-prd
    Przeprowadza przegląd niejednoznaczności w PRD.md i domyka każdy niedookreślony punkt przed słownikiem lub architekturą, tak aby dwóch inżynierów nie zbudowało z niego różnych rzeczy.
  • 100clarify-idea
    Doprecyzowuje niejasny pomysł użytkownika w rozmowie przed ekstrakcją lub planowaniem: lista niejasności, bramka rozbicia zakresu, pytania pojedynczo i bramka gotowości.
  • 100refine-requirements
    Doprecyzowuje wymagania funkcji przez celowane pytania uzupełniające, a potem aktualizuje lub tworzy zadania na podstawie odpowiedzi.

Uwagi i zgłoszenia

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