clarify-intent-and-establish-shared-understanding — скилл

Скилл допрашивает план до начала работы: вопросы раундами с рекомендованным ответом, без правок до вашего подтверждения

  • 205 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл разрешает агенту использовать любые доступные инструменты, поиск и субагентов для проверки фактов, поэтому в ходе раундов он может читать файлы проекта и ходить в сеть
Все причины и проверки

inference1/clarify-intent-and-establish-shared-understanding

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/clarify-intent-and-establish-shared-understanding

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл разрешает агенту использовать любые доступные инструменты, поиск и субагентов для проверки фактов, поэтому в ходе раундов он может читать файлы проекта и ходить в сеть

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл превращает расплывчатый запрос в согласованное понимание задачи до того, как агент что-нибудь сделает. Он строит неявное дерево решений и проходит его раундами: в каждом раунде агент задает сразу все вопросы, для которых уже известны предпосылки, нумерует их и прикладывает к каждому рекомендуемый ответ. Вопросы, зависящие от еще не решенных, откладываются на следующий раунд. Факты, которые можно взять из каталога проекта, файлов, репозитория и подключенных инструментов, агент проверяет сам. Людям остаются суждения, приоритеты, допустимые потери и недостающие сведения. По ходу скилл пересказывает общее понимание, разделяет подтвержденные факты, допущения, трактовки и открытые решения, ищет противоречия и пересматривает прежние выводы, если новые ответы меняют картину. Пока вы явно не подтвердите общее понимание, агент ничего значимого не выполняет, не публикует и не завершает. Для этого должны быть решены зависимости, названы измеримые критерии успеха и приняты главные допущения.

Для кого. Тем, кто ставит агенту дорогие или необратимые задачи, например исследование, миграцию или архитектурное решение, и хочет сначала проверить свой план на дыры.

Подходит, если

  • Перед большим исследованием или миграцией хочется, чтобы агент допросил план: достаточно написать «grill me» или «pre-mortem»
  • В запросе скрыты допущения, и результат может разойтись с ожиданиями: вопросы раундов вытаскивают их на поверхность
  • Стратегию или предложение надо раскритиковать до принятия: скилл срабатывает на запросы о «red-team review» и «decision audit»
  • Требования противоречат друг другу: скилл ищет такие места и возвращается к принятым решениям, если ответы меняют картину
  • Перед стартом нужен письменный итог согласованного: скилл периодически сводит общее понимание и просит подтверждения

Не подходит, если

  • Задача мелкая и очевидная: раунды вопросов замедлят работу, а сам скилл оговаривает баланс строгости и скорости
  • Агент должен сразу писать код: до подтверждения скилл ничего не выполняет
  • Нужен строго один вопрос за раз: этот скилл задает в раунде все вопросы, ответ на которые не зависит от других
  • Сессия идет автоматически без человека: скилл ждет ответов и явного подтверждения

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

Прогрилль мой план миграции с MongoDB на Postgres: задай вопросы раундами и ничего не меняй, пока я не подтвержу общее понимание

Ограничения

  • README и SKILL.md расходятся: README обещает один вопрос за раз, а SKILL.md описывает раунды из нескольких вопросов. Работает поведение из SKILL.md.
  • Скилл срабатывает только по явной просьбе о строгой проверке («grill», «pressure-test», «red-team», «pre-mortem», «decision audit»), на обычные запросы он не включается.
  • В репозитории только инструкция на английском: скриптов, шаблонов и примеров ответов нет.
  • Скилл разрешает агенту использовать любые доступные инструменты и поиск для проверки фактов, поэтому ограничения по сети задавайте настройками агента.

Как отключить. Удалите папку скилла из `.claude/skills/` (или `~/.claude/skills/` при глобальной установке), либо повторите установку через `npx skills` с удалением по инструкции этой утилиты.

Частые вопросы

Как поставить скилл в Claude Code?

Выполните `npx skills add Inference1/clarify-intent-and-establish-shared-understanding -a claude-code`. Для установки на все проекты добавьте `-g`, а ключ `--all` ставит скилл всем поддерживаемым агентам.

Как включить скилл в разговоре?

Попросите прямо: «прогрилль этот план», «сделай pre-mortem», «проведи red-team review». Можно вызвать и командой `/clarify-intent-and-establish-shared-understanding`. На обычные просьбы скилл не отзывается.

Что агент делает, пока вопросы не закрыты?

Проверяет доступные факты и ведет вопросы, но не правит файлы, не отправляет и не публикует. Продолжить он вправе после того, как вы подтвердите общее понимание.

Обязательно ли принимать рекомендованный ответ?

Нет. К каждому вопросу прилагается рекомендация, но решение остается за вами: можно согласиться с вариантом или назвать свой.

Как поставить скилл без npx?

Склонируйте репозиторий и скопируйте папку так, чтобы внутри остался `SKILL.md`: в `.claude/skills/` проекта или в `~/.claude/skills/`. Для Codex и Cursor проектный каталог — `.agents/skills/`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

18 скиллов и 6 агентов для UX-стратегии: от исследования и потоков до доступности, этики и передачи в разработку

СкиллМинимальный доступ246Звезды репозитория

Скилл для Claude Code: агент задает по одному вопросу с вариантами ответа, пока не разберет план или дизайн до последней развилки

СкиллМинимальный доступ1,4 тыс.Звезды репозитория

Личная коллекция скиллов cafe3310: ведение проекта по спецификации, обзор кода, отчеты, браузер, 3D и видео в одном репозитории

СкиллРасширенный доступ256Звезды репозитория

Скилл для докладов руководству и инвесторам: собирает текст по схеме из пяти частей и сверяет его с чек-листом перед отправкой

СкиллМинимальный доступ201Звезды репозитория

Скилл помогает агенту вести журнал, план и выводы проекта в файлах и переносить проверенные уроки в Obsidian, Notion или Lark

СкиллШирокий доступ253Звезды репозитория

Qiushi Skill

求是 Skill

Набор скиллов с методологией работы: сначала разобраться в фактах, выделить главное противоречие, проверять на практике и доводить дело до конца

СкиллМинимальный доступ3,9 тыс.Звезды репозитория

Коротко о README

Страница начинается с трех способов установки: просьба агенту, `npx skills add` с вариантами для одного агента и для всех, и ручное копирование с таблицей каталогов Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI. Затем идет введение о дилемме между автономностью и взаимодействием и о ценности предварительного уточнения, описание того, когда срабатывает скилл, и обоснование его пользы.

Бейдж для README

Исходный SKILL.md

---
name: clarify-intent-and-establish-shared-understanding
description: Whether you're thinking or getting things done, be clear, specific, and methodical. Grounded in first principles, rigorously examine and refine a user's task, decision, plan, goal, strategy, proposal, or idea through structured, progressively deeper questioning, in order to bridge the gap between the User and the Agent. Use when the user explicitly requests grilling, challenge, pressure-testing, cross-examination, red-team review, pre-mortem analysis, or a decision audit. The goal is to uncover unclear objectives, hidden assumptions, contradictions, weak evidence, missing information, overlooked constraints, dependencies, risks, trade-offs, failure modes, and misalignment between intended outcomes and real-world results. Begin by establishing a shared understanding of the user's actual intent, plans, goals, rules, constraints, and success criteria. Ask focused, high-leverage questions rather than broad or repetitive ones. Adapt each question based on previous answers, probing deeper where uncertainty, unsupported assumptions, or strategic weaknesses remain. Regularly summarize the current understanding of the user's precise intent and position to confirm alignment, expose misunderstandings, and refine the problem or goal definition. Distinguish facts, assumptions, hypotheses, and unknowns. Challenge reasoning rigorously while remaining constructive, respectful, and solution-oriented. Continue until the reasoning is internally coherent, evidence-aware, constraint-conscious, risk-assessed, and translated into a clearer, more actionable goal, decision, or plan. Ultimately, achieving the super-alignment between the User and the Agent.
---

**Simplicity** should be pursued to the greatest extent possible without compromising essential details, accuracy, or conceptual integrity.

**Interrogate the user systematically until both sides share a precise, complete understanding of the intent, problem, goal, task, constraints, priorities, assumptions, and desired outcomes**.

Construct and navigate an implicit decision tree. Resolve foundational choices before dependent ones, identify hidden assumptions, detect contradictions, and revisit previous conclusions when new information changes the **decision landscape**.

**Proceed through the decision tree iteratively, one round at a time**. At each round, define the frontier as the set of decisions whose prerequisites have already been resolved; in other words, it consists of the questions that can be asked without making assumptions about information that has not yet been provided. Present all questions on the current frontier within a single round, number them sequentially, and provide a recommended answer for each question. Do not proceed to the next round until the user has responded to the questions presented in the current round.

Format a round like so:

```
❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>

➡️ <your recommended answer>

---

❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>

➡️ <your recommended answer>
```

In each round, the user's answers reshape the decision tree: resolved decisions extend the frontier and unlock questions that depend on them. Recompute the frontier accordingly and then present the next round of questions. Any question whose answer depends on another unresolved question in the current round should be deferred to a subsequent round.

Do not combine independent questions. Each question should:

- target a specific unresolved decision or ambiguity;
- briefly explain why the answer affects the outcome;
- provide a clearly labeled recommended option when sufficient context exists;
- preserve user agency by making clear that the final choice belongs to the user.

You may use any and all available tools, network proxies, agents, and search resources.

Do not ask for information that can be reliably obtained from available context, current working directory, code repositories, files, tools, connected sources, or other authorized inputs. **Retrieve or verify such information directly when possible**. Reserve questions for human judgment, preferences, priorities, acceptable risks, subjective trade-offs, or unavailable facts.

**Continuously restate and refine the emerging understanding**. Identify ambiguities, contradictions, unresolved dependencies, missing success criteria, and differences between stated requests and likely underlying goals.

Continuously maintain a shared mental model by:

- summarize the current understanding when meaningful progress is made;
- separate confirmed facts, assumptions, interpretations, and open decisions;
- highlight ambiguity, conflicting requirements, missing constraints, and unclear evaluation criteria;
- check whether the inferred objective matches the user's actual intent.

**Do not execute, implement, modify, submit, publish, or finalize any consequential output until**:

1. the relevant decisions, dependencies, and constraints have been resolved;
2. the desired outcome and measurable success criteria are explicit;
3. major assumptions and trade-offs have been surfaced and accepted;
4. the user explicitly confirms that shared understanding has been reached.

**Maintain a balance between rigor and efficiency**. Be persistent enough to prevent avoidable misunderstandings, but avoid unnecessary interrogation. Prioritize clarity, alignment, and forward progress over exhaustive questioning.

Сообщить о проблеме

Foxx AIclarify-intent-and-establish-shared-understanding
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.