reflect-skill — плагин для Claude Code: рефлексия по ходу диалога
Останавливает работу над деталями и перечитывает весь разговор с исходной цели: где вы свернули не туда и что упустили.
/plugin marketplace add alirezarezvani/claude-skills
/plugin install reflect-skill@claude-code-skillsЧто делает reflect-skill
Скилл включается посреди разговора — по слову «reflect» или когда вы десять с лишним ходов копаетесь в деталях без стратегической сверки. Он замирает на текущей ветке и перечитывает диалог с самого начала, а не только последние реплики. Дальше идёт разбор по пяти направлениям: исходная цель против текущего курса, непроверенные допущения и пропущенные ограничения, правильность постановки задачи, когнитивные искажения (подтверждения, невозвратных затрат, якоря, сложности, недавности) и соответствие направления реальным целям.
Отвечает связным текстом без заголовков и заканчивает одной рекомендацией: Continue, Pivot или Pause. Внутри лежит агент-персона, слэш-команда /cs-reflect и три скрипта на стандартной библиотеке Python — один ищет в разговоре сигналы пяти искажений, второй считает глубину диалога и ловит неявные триггеры, третий проверяет, что вывод правда заканчивается одним из трёх вердиктов. Справочники описывают канон рефлексивной практики Шёна и дисциплину честного вывода.
Зависимостей нет: это чистое рассуждение, поэтому скилл работает и в Claude CLI, и в Claude.ai. Полезно знать главное правило — скилл не выдумывает проблемы, если курс верный. «Всё хорошо» он не скажет: либо назовёт конкретную причину, почему путь крепкий, либо приведёт доказательства из разговора, почему его надо менять. Если ждёте от инструмента критику ради критики, это повод поискать другой.
Какие задачи решает
- остановиться и сверить текущий курс с исходной целью
- найти непроверенные допущения и пропущенные ограничения
- распознать искажение подтверждения или невозвратных затрат в споре
- понять, не усложнили ли вы простую задачу
- получить вердикт Continue, Pivot или Pause вместо общих слов
Примеры запросов агенту
- reflect — мы уже десять ходов правим детали, посмотри, туда ли идём
- /cs-reflect: проверь, не упускаем ли мы что-то важное
- step back и скажи честно, правильную ли задачу мы вообще решаем
Как установить reflect-skill
Через маркетплейс плагинов
/plugin marketplace add alirezarezvani/claude-skills/plugin install reflect-skill@claude-code-skillsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о reflect-skill
Как установить reflect-skill в Claude?
Добавьте маркетплейс командой /plugin marketplace add alirezarezvani/claude-skills, затем поставьте плагин: /plugin install reflect-skill@claude-code-skills.
Что делает reflect-skill?
Прерывает работу над деталями, перечитывает разговор с исходной цели и разбирает его по пяти направлениям — от дрейфа курса до когнитивных искажений. Заканчивает рекомендацией Continue, Pivot или Pause.
Нужны ли зависимости для работы?
Нет. Скилл построен на чистом рассуждении, скрипты используют стандартную библиотеку Python, и он работает в Claude CLI и в Claude.ai.
Исходный текст
reflect · MIT
# reflect
Mid-conversation reflection skill. Pauses execution and **zooms out from detail-mode** to honestly reassess direction, assumptions, and bias.
## What this skill does
When invoked mid-conversation (explicitly or via implicit signals like 10+ turns deep on details without strategic check-in), the skill:
1. **Halts the current thread** and re-reads the full conversation from the original goal forward — not just recent turns
2. Runs the **5-dimension analysis framework**:
- **Macro Perspective** — original goal vs current direction; drift detection
- **Gap Analysis** — unverified assumptions, missing stakeholders, skipped constraints, dismissed alternatives
- **Reflective Inquiry** — is the problem framed correctly? Right problem vs adjacent easier one? Simpler path overcomplicated? Harder valuable path avoided?
- **Bias Check** — confirmation / sunk cost / anchoring / complexity / recency
- **Contextual Alignment** — does direction serve actual goals + best use of time + external factors honored
3. Delivers **flowing prose** (no headers, conversational tone)
4. Ends with a **clear directional recommendation**: Continue / Pivot / Pause
## Sibling skill relationship
Productivity sibling of `capture` (Slice 1). Both share light-prompt-flow shape, max-1-question intake, fast-to-action discipline. Different mode: `capture` organizes external dumps; `reflect` re-examines internal conversation state.
## Honest-output discipline
The skill explicitly does NOT manufacture problems when things are on track. "This is solid because X" is a valid output. **Vague reassurance ("looks good!") is rejected** — when the path is solid, the skill states specific reasoning for why; when the path needs correction, the skill states specific evidence from the conversation.
## Source spec
`megaprompts/02-reflect-megaprompt.md` (maintainer-local draft spec — gitignored, not in the public repo) (PR #657).
## Plugin layout
```
productivity/reflect/
├── .claude-plugin/plugin.json
├── README.md
├── agents/cs-reflect.md ← reflection persona, honest-output enforcer
├── commands/cs-reflect.md ← /cs-reflect (or auto-triggers on phrases)
└── skills/reflect/
├── SKILL.md
├── references/
│ ├── cognitive_bias_canon.md ← 5 biases + recognition cues (7+ sources)
│ ├── honest_output_discipline.md ← anti-manufactured-problems (7+ sources)
│ └── conversation_reflection_practice.md ← Schön reflective practice canon (7+ sources)
└── scripts/
├── bias_pattern_detector.py ← stdlib: regex scan for 5-bias signals in conversation
├── conversation_depth_analyzer.py ← stdlib: turn count + implicit-trigger signal detection
└── directional_recommendation_validator.py ← stdlib: verify output ends with Continue/Pivot/Pause
```
## Dependencies
**None.** Pure-reasoning skill — most portable in the v2 collection. Works in Claude Code CLI + Claude.ai web natively.
## License
MIT.
© Alireza Rezvani · MIT · alirezarezvani/claude-skills
