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

clarify

/clarify

Wyjaśnia, co w prośbie lub specyfikacji jest niejednoznaczne, zanim zacznie się planowanie.

Repozytorium
dalcom-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.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

Wyjaśnia, co w prośbie lub specyfikacji jest niejednoznaczne, zanim zacznie się planowanie.

Wyzwalacze z opisu

clarifywhat is ambiguous here
Oryginalny opis (EN)

Use when the user says "clarify", "what is ambiguous here", or when a prompt or spec reads as under-specified before planning. Not for exploring intent with questions: use askme.

Jak działa

  1. Pick the target
  2. Restate it before you scan
  3. Look facts up before asking
  4. Sort every finding by certainty
  5. Report, then ask only what you must
Sekcje z nagłówków SKILL.md, w oryginale · 46 linii, 637 słów
Podgląd SKILL.md
---
name: clarify
description: 'Use when the user says "clarify", "what is ambiguous here", or when a prompt or spec reads as under-specified before planning. Not for exploring intent with questions: use askme.'
---

# Clarify

An under specified request answered confidently is still the wrong answer. This skill scans a prompt or spec for ambiguity before anyone plans against it, looks up everything the repo itself can settle, and brings back only the questions a human genuinely needs to answer. It reads everything and writes nothing: the deliverable is chat text, and no file, credential, deployment, or remote state changes.

## Pick the target

Scan one target, chosen by strict precedence: an explicit argument (`clarify <text-or-path>`) first, else the most recent user request when it reads as a spec or task, else the open conversation context. When one read of the context yields no identifiable target, stop and ask exactly one question naming what to scan. Scanning nothing is a failure, not an empty result.

## Restate it before you scan

Write the target back as a single paraphrased instruction, including what it does not ask for, and compare that restatement against the target. A mismatch is the first finding and outranks every other finding, because a correct answer to a misread request is still wrong. When the restatement matches, it stays silent unless a fork survives later; the report below is the deliverable, not the restatement.

## Look facts up before asking

Pre scan the facts before surfacing anything to the user. Resolve every ambiguity that is actually an environmental or codebase fact by direct lookup (search, read, or a subagent); never ask the user for something the repo can answer. Each resolved fact is recorded as tier `auto` with its basis, reported compactly, and never becomes a question. A lookup that fails or stays inconclusive is not an `auto` finding; it falls through to normal tiering below. Never guess a fact to avoid asking.

## Sort every finding by certainty

Give each remaining finding exactly one tier:

*   `auto`: an unambiguous project convention resolves it. Record the resolution and basis, then proceed.
*   `gated`: a reasonable default exists. Surface it as a recommendation that locks unless the user overrides it.
*   `manual`: evidence cannot settle genuine intent. Surface a non locking recommendation based on the least irreversible standard choice, then ask.
*   `fyi`: worth noting, never worth blocking on. List it and never ask about it.

Then enforce MECE over the set: merge or drop findings that ask the same thing as, or overlap, another finding, so nothing asks twice.

## Report, then ask only what you must

Emit a findings report grouped by tier with `manual` last. Each finding carries one block with these fields:

*   `id`
*   `quote` (the exact ambiguous span)
*   `tier`
*   `recommendation` (an em dash for `fyi`)
*   `basis` (the fact or convention supporting it)

`gated` recommendations are marked locked unless overridden; `manual` ones are non locking; `auto` resolutions appear compactly with their basis. On explicit request for structured output, follow the report with one fenced `clarify-findings/v1` block holding a YAML list of the per finding fields.

Then ask only the `manual` tier: one single select question per `manual` finding with its non locking recommendation marked, at most four questions per fire. At zero `manual` findings there is nothing to ask; the report alone is the result.

After the user's overrides, re scan the target once and stop when the re scan adds no new `manual` finding. Record every settled finding as overridden, answered, or discharged as a non issue with a one line reason; open `manual` findings left unanswered mean the work is incomplete, so state that and list their ids rather than claiming completion. A span that was unreadable or unreachable means emitting what was found, naming the excluded span, and not claiming the scan is done.

List any project specific term the user settled during clarification as a CONCEPTS.md candidate in the report. Record the candidate; write no files.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · gosuda/dalcom-skills90Apache-2.0
ericrisco/rsc-harness100MIT
growupanand/ConvoForm100Apache-2.0
mcouthon/agents100MIT
ramboz/jig100MIT
ramboz/jig100MIT
ramboz/jig100MIT
umputun/cc-thingz100MIT
ronakrupani/clarify100MIT

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

  • 100s08-03-spec-clarify
    Szuka w specyfikacji niejasności i braków, przedstawia użytkownikowi wybory do rozstrzygnięcia i zapisuje decyzje w spec.md.
  • 100clarify-intent
    Wyjaśnia cel i język dziedziny, gdy wymagania są niejasne lub brak kryteriów akceptacji, zanim powstanie kod.
  • 90sdlc-clarify
    Zadaje najwyżej pięć pytań, żeby wyjaśnić otwarte kwestie w szkicu specyfikacji, i zapisuje odpowiedzi z powrotem do dokumentu.
  • 86discovery-questions
    Wyjaśnia decyzję, sytuację użytkownika i potrzebne dowody, zanim zacznie się eksploracja UI lub UX, także przy zmienionym briefie.
  • 100cds-brainstorming
    Wyjaśnia, co należy zbudować, zanim zacznie się planowanie, gdy problem jest niedookreślony, oczekiwany wynik niejasny lub istnieją istotnie różne kierunki do zbadania.
  • 95interview
    Prowadzi wywiad o wymaganiach, gdy zadanie jest niejasne, zanim zacznie się planowanie wdrożenia.

Uwagi i zgłoszenia

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