clarify
/clarify
Przeprowadza ograniczone doprecyzowanie przed sfinalizowaniem planu fazowego, gdy zostają nierozwiązane znaczniki [?] lub niejednoznaczności zmieniające plan.
- Autor
- mcouthon ↗
- Repozytorium
- agents ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 25.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.
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
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
- When to run
- Two delivery modes
- Ambiguity scan
- How to run the pass
- Open clarifying questions block format (subagent mode)
- Recording format (task.md)
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · mcouthon/agents | 100 | MIT |
| ericrisco/rsc-harness | 100 | MIT |
| growupanand/ConvoForm | 100 | Apache-2.0 |
| ramboz/jig | 100 | MIT |
| ramboz/jig | 100 | MIT |
| ramboz/jig | 100 | MIT |
| umputun/cc-thingz | 100 | MIT |
| ronakrupani/clarify | 100 | MIT |
| andreibesleaga/gabbe | 100 | CC-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.