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

clarify · zaxbyhub — скилл для Claude Code: что делает и как установить

Скилл clarify разбирает неясные требования через четырёхэтапную воронку с проверкой критиком и готовит пакет решений без лишних вопросов.

MIT ★ 539 обновлён 2026-10-29

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

Что делает clarify

Скилл подключается архитектором при переходе в режим MODE: CLARIFY. Сначала протокол собирает все неопределённости вокруг проекта: границы задачи, деструктивные операции, безопасность, обратную совместимость, миграции и влияние на платформы. Жёсткого лимита на этот внутренний список нет.

Каждый пункт относится к одной из категорий: разрешённые агентом (self_resolved), переданные критику (critic_resolved), требующие исследования (research_needed), отложенные (deferred_nonblocking) или требующие выбора пользователя (user_decision). На этап research_needed отводится пятиминутный бюджет: если поиск затягивается, пункт автоматически становится решением для человека. Затем подключается доска критика critic_sounding_board с вердиктами UNNECESSARY, RESOLVE, REPHRASE или APPROVED.

Темы вроде риска потери данных, ломающих правок API и изменения скоупа запрещено отбрасывать вердиктом DROP: скилл принудительно возвращает их на утверждение человеку. Итоги без вопросов пользователю фиксируются как допущения в плане, спецификации или файле .swarm/context.md.

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

  • отфильтровать лишние вопросы пользователю перед планированием архитектуры
  • зафиксировать риски потери данных и поломки API перед началом работ
  • ограничить зависшие внешние исследования пятиминутным лимитом
  • сохранить принятые допущения в спецификации и файле .swarm/context.md

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

  • Проверь требования к миграции базы данных через протокол clarify
  • Запусти протокол clarify для новой задачи с неполным описанием API

Как установить clarify

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill clarify -a claude-code

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

~/.claude/skills/clarify/SKILL.md

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

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

Вопросы о clarify

Как установить clarify в Claude Code?

Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill clarify -a claude-code в терминале.

Что делает скилл clarify?

Он прогоняет неопределённости задачи через четыре этапа фильтрации, привлекает критика и собирает оставшиеся развилки в понятный пакет решений.

Что происходит, если исследование затягивается дольше 5 минут?

По истечении пятиминутного бюджета пункт автоматически переходит в статус user_decision с пометкой о незавершённом поиске и передаётся пользователю.

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

SKILL.md · MIT
---
name: clarify
description: >
  Full execution protocol for MODE: CLARIFY -- structured clarification funnel with critic review before surfacing user decisions.
metadata:
  audience: swarm-plugin
---

# Clarify Protocol

This protocol is loaded on demand by the architect runtime. The architect prompt keeps only activation, action, and hard safety constraints; the full execution details live here.

### MODE: CLARIFY
Ambiguous request → Run the clarification funnel
Clear request → MODE: DISCOVER

### Clarification Funnel

Before surfacing any clarification question to the user, the architect MUST run this four-stage funnel. The goal is to limit unnecessary user interruption, not planning completeness.

#### Stage 1: Inventory All Material Uncertainties

Identify ALL uncertainties that could affect:
- Scope boundaries
- User-visible behavior
- Destructive behavior or data loss
- Security/privacy posture
- Backward compatibility
- Migrations or rollout strategy
- Cost/performance tradeoffs
- Operational complexity
- QA gate selection or enforcement strictness
- Architecture choice among materially different paths
- Dependency or platform assumptions

There is NO hard cap on the internal inventory. Record every material uncertainty found.

#### Stage 2: Classify Each Uncertainty

Classify each item as exactly one of:
- `self_resolved`: answered from the user request, spec, plan, codebase reality check, `.swarm/context.md`, repo conventions, or an informed default. **If the default is not directly supported by user request, spec, or recorded context, classify as `user_decision` rather than `self_resolved`.**
- `critic_resolved`: sent to Critic Sounding Board and resolved by the critic.
- `research_needed`: needs SME/explorer/domain lookup before user escalation. **Important:** If research is ongoing, apply a fixed 5-minute protocol budget to `research_needed`. If research does not complete before the budget expires, automatically reclassify the item to `user_decision` with a note that research was incomplete, then surface it to the user. This prevents the clarification funnel from stalling while waiting for external research.
- `user_decision`: only the user can decide because it affects product scope, risk tolerance, policy, budget, UX, rollout, or destructive behavior.
- `deferred_nonblocking`: useful follow-up detail that does not block a correct initial plan and can be explicitly recorded as an assumption or follow-up.

#### Stage 3: Consult Critic Sounding Board

Before asking the user any clarification question, the architect MUST consult `critic_sounding_board` with the candidate question set and context.

For each item classified as `research_needed` or `user_decision` in Stage 2, send it to the critic. The critic responds with a verdict from the `SoundingBoardVerdict` enum (`UNNECESSARY | RESOLVE | REPHRASE | APPROVED`). The mapping between critic verdicts and funnel actions is:

| Critic Verdict (SoundingBoardVerdict) | Funnel Action | Meaning |
|---|---|---|
| `UNNECESSARY` | DROP | Item is unnecessary or answerable from existing context |
| `RESOLVE` | RESOLVE | Critic supplies the answer or recommended default |
| `REPHRASE` | REPHRASE | Question is valid but should be clearer, narrower, or grouped |
| `APPROVED` | ASK_USER | User decision is genuinely required |

**Hard constraint:** Items in the Always-Surface Categories list (below) MUST NOT receive `UNNECESSARY`/`DROP` from the critic — only `REPHRASE` or `APPROVED`/`ASK_USER` are allowed. If the critic attempts to `UNNECESSARY`/`DROP` an always-surface item, override to `APPROVED`/`ASK_USER`.

**Overconfidence guard:** If the critic attempts to self-resolve an item by supplying an answer (verdict `RESOLVE`) but the underlying default is not directly supported by user request, spec, or recorded context, the architect MUST classify the item as `user_decision` rather than `self_resolved`. Unsupported defaults must not be silently accepted.

Update classifications based on critic response:
- `UNNECESSARY`/`DROP` → reclassify as `self_resolved` and record the reason.
- `RESOLVE` → reclassify as `critic_resolved` and record the answer as an assumption.
- `REPHRASE` → update the question wording and keep as candidate.
- `APPROVED`/`ASK_USER` → confirm as `user_decision`.

Record all resolved items as explicit assumptions before proceeding.

#### Stage 4: Surface User Decision Packet

If any items remain classified as `user_decision` after Stage 3, present them as a structured decision packet — NOT as an arbitrary subset.

The packet MUST include for each decision:
- Category grouping (scope, security, compatibility, performance, UX, rollout, QA policy)
- Why the decision matters
- Recommended default when safe
- Options being weighed
- Impact of accepting the default
- Blocking vs optional marker

The architect MAY ask questions one at a time in interactive mode, but MUST preserve and report the full unresolved list. The architect MUST NOT drop unresolved decisions because of a session question cap.

### Always-Surface Categories

The critic may improve wording or confirm prior context, but these categories MUST be surfaced to the user unless already explicitly answered by the user or by recorded context:
- Scope boundaries: what is in or out
- Data loss or destructive behavior
- Security/privacy risk tolerance
- Backward compatibility or migration policy
- Breaking changes to existing APIs, contracts, or interfaces
- New dependency additions or version changes
- Deprecation decisions for existing features or APIs
- Cross-platform impact (Windows/macOS/Linux differences)
- Cost/performance tradeoffs
- User-visible behavior and UX choices
- Release/rollout strategy
- Optional QA gates or stricter enforcement modes
- Any choice that changes whether the work is advisory vs hard-blocking

### Assumptions Recording

All items resolved in Stages 2-3 (self_resolved, critic_resolved, deferred_nonblocking) MUST be recorded as explicit assumptions in the spec, plan, or `.swarm/context.md`. Silently dropping resolved uncertainties is a protocol violation — every uncertainty that entered the funnel must have a recorded outcome.

### Mechanical Enforcement of DROP Protection

**Implementation Note:** The hard constraint against `DROP` on always-surface items (defined in Stage 3 of the clarification funnel) is currently enforced via skill instructions to the architect. A lightweight runtime enforcement mechanism is recommended: when the critic sounding board verdict response is parsed, validate that any items tagged as "always-surface" do not receive `UNNECESSARY`/`DROP` verdicts. If a DROP verdict is encountered on an always-surface item, override it to `APPROVED`/`ASK_USER` at the code level rather than relying solely on prompt-based enforcement.

This mechanical enforcement prevents the following failure mode: the architect prompt instructs the override, but due to parsing errors, context limits, or model behavior variance, the DROP verdict is mistakenly applied to an always-surface item and silently accepted. The validation should occur in the decision-packet assembly code (when building the final clarification packet to surface to the user) and should emit a warning log when an override is applied. This is tracked as future work in a follow-up issue; until then, enforcement relies on the skill instructions.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — clarify от других авторов.

clarify aladicf Скилл clarify для Claude Code помогает переписать запутанные тексты интерфейса и продукта. Запускается командой /clarify, когда нужно прояснить подписи, ошибки, инструкции или призывы к действию. CX Codex +1 615установок clarify mag123c Скилл clarify уточняет требования к задаче, выбирает глубину анализа по сложности и готовит план реализации. При росте неопределённости переходит к исследованию кодовой базы. CX Codex +1 ★ 196звёзд репо discover-networking rand Скилл discover-networking распознаёт задачи по сетям и подключению, затем помогает находить подходящие скиллы из набора cc-polymath. Пригодится при работе с протоколами, VPN и устойчивостью соединений. CX Codex +1 120установок how cursor Скилл how для Claude Code объясняет устройство подсистем, поток выполнения и распределение кода по пакетам. Его вызывают с вопросами о том, как работает код и где разместить изменение. CX Codex +1 7 100установок repo-orchestration objectivlabs Скилл repo-orchestration для Claude Code проектирует целевое состояние системы и собирает план внедрения. Включается при запросах спланировать задачи или подготовить архитектурный дизайн. CX Codex +1 431установок open-standards-strategy Samuel Berthe Скилл open-standards-strategy для Claude Code помогает выбрать позицию компании по конкретному открытому стандарту или протоколу. Он включается при обсуждении участия в разработке стандарта, совместимости или конкурирующей спецификации. CX Codex +1 13 700установок ensemble-solving mhattingpete Скилл ensemble-solving запускает трёх субагентов для параллельного поиска решений задачи, сравнивает подходы по шкале критериев и выдаёт лучший вариант с разбором альтернатив. CX Codex +1 218установок recursive-synthesis curiositech Скилл recursive-synthesis оркестрирует мультиагентный синтез документов через 6 фаз: от расходящихся позиций до финального документа. Подходит для конституций, хартий и архитектурных решений. CX Codex +1 138установок

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

Весь набор →
contributing Скилл contributing проводит агента по всему циклу пул-реквеста в репозитории opencode-swarm: ветка, формат коммитов, фрагмент release notes, локальные проверки и шаблон описания. CX Codex +1 ★ 539звёзд репо clarify-spec Скилл clarify-spec устраняет маркеры неопределённости в спецификациях Swarm, опрашивая разработчика по одному вопросу за раз. CX Codex +1 ★ 539звёзд репо pre-phase-briefing Скилл pre-phase-briefing собирает контекст перед фазой проекта, проверяет прошлые ретроспективы и сверяет план с реальным состоянием кодовой базы. CX Codex +1 ★ 539звёзд репо rust-crate-ci Скилл rust-crate-ci для правки Rust-крейта runners/swarm-sandbox-runner: задаёт порядок локальных проверок и разбирает ошибки Windows, которые видит только CI. CX Codex +1 ★ 539звёзд репо editing-skills Скилл editing-skills помогает менять SKILL.md в opencode-swarm, не нарушая правила зеркалирования, публикации и проверки расхождений. Загрузите его перед редактированием скиллов в этом репозитории. CX Codex +1 ★ 539звёзд репо pr-reviewer Субагент pr-reviewer для ревью пул-реквестов в плагине opencode-swarm: восстанавливает замысел PR, сверяет его с кодом и ищет дефекты. Работает только на чтение. CX Codex +1 ★ 539звёзд репо git-revert-safety Скилл git-revert-safety помогает безопасно откатывать коммиты и мержи в Git без поломки версий в релизных манифестах и локфайлах. CX Codex +1 ★ 539звёзд репо qa-sweep qa-sweep организует параллельную работу субагентов и независимую проверку изменений. Скилл пригодится при реализации функций, исправлении ошибок и разборе сбоев. CX Codex +1 ★ 539звёзд репо

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

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