@gian-tiaga/eda 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/README.md +1 -1
  2. package/docs/skills/eda-automate.md +10 -2
  3. package/docs/skills/eda-commit.md +11 -2
  4. package/docs/skills/eda-docs.md +10 -2
  5. package/docs/skills/eda-execute.md +11 -2
  6. package/docs/skills/eda-fix-by-review.md +11 -2
  7. package/docs/skills/eda-plan.md +32 -9
  8. package/docs/skills/eda-research.md +21 -6
  9. package/docs/skills/eda-review.md +31 -7
  10. package/docs/skills/eda-send-review.md +11 -2
  11. package/package.json +1 -1
package/README.md CHANGED
@@ -76,7 +76,7 @@ flowchart LR
76
76
  ## 🎯 Главные принципы
77
77
 
78
78
  - **Простой язык.** Скилы общаются с тобой так, чтобы понял человек без глубоких знаний предмета. Термины — только когда без них нельзя.
79
- - **Все вопросы — структурированно.** Никаких «а уточни, пожалуйста, на какую ветку?» в свободном тексте. Только через `AskUserQuestion` (или нумерованный список в Codex).
79
+ - **Все вопросы — интерактивно.** В Claude Code — через `AskUserQuestion`; в интерактивном Codex — через `request_user_input` или блокирующий вопрос в чат. В `codex exec` и других неинтерактивных запусках скил не имитирует диалог: если без ответа нельзя безопасно продолжать, он завершает работу со статусом `blocked: нужен ответ пользователя`.
80
80
  - **Артефакты по папкам.** Исследования отдельно, планы отдельно, ревью отдельно. Между файлами — ссылки. Через месяц легко найти, кто что когда решал.
81
81
  - **Границы между скилами жёсткие.** `execute` не коммитит — это работа `commit`. `review` не правит код — это `fix-by-review`. Никаких размытых ответственностей.
82
82
  - **Доверие модели.** Скилы короткие. Они говорят «что» и «почему», а «как именно» — модель разбирается сама.
package/docs/skills/eda-automate.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-automate
3
- description: Анализирует историю `docs/reviews/` и `docs/review-fixes/`, ищет повторяющиеся замечания и предлагает автоматизации — кастомные правила линтеров, статанализаторов, pre-commit-проверок. Опирается на инструменты, которые уже работают в проекте; если ничего не подходит — предлагает новый, без дублей с уже установленными. Не внедряет автоматизации — выдаёт приоритезированный список с черновиками правил. Внедрение — отдельная задача через `eda-plan` + `eda-execute`. Все вопросы — через AskUserQuestion.
3
+ description: Анализирует историю `docs/reviews/` и `docs/review-fixes/`, ищет повторяющиеся замечания и предлагает автоматизации — кастомные правила линтеров, статанализаторов, pre-commit-проверок. Опирается на инструменты, которые уже работают в проекте; если ничего не подходит — предлагает новый, без дублей с уже установленными. Не внедряет автоматизации — выдаёт приоритезированный список с черновиками правил. Внедрение — отдельная задача через `eda-plan` + `eda-execute`. Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Автоматизатор (eda-automate)
@@ -10,12 +10,20 @@ description: Анализирует историю `docs/reviews/` и `docs/revi
10
10
  ## Главные правила
11
11
 
12
12
  1. **Прочитай `docs/rules.md` и `docs/arch.md`**, если есть. Не предлагай то, что уже зафиксировано как автоматизированное правило.
13
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex — короткий нумерованный список).
13
+ 2. **Интерактивные вопросы** — по разделу ниже.
14
14
  3. **Не внедряешь автоматизации.** Только отчёт с предложениями. Внедрение — `eda-plan` + `eda-execute`.
15
15
  4. **Предлагай только повторяющееся.** Минимум — паттерн встречается в 2+ разных ревью или в 3+ местах одного. Единичные замечания не автоматизируем.
16
16
  5. **Каждое предложение — с черновиком правила.** Не «надо бы что-то сделать», а конкретный фрагмент: имя инструмента, имя правила, псевдокод/skeleton.
17
17
  6. **Простой язык. Таблицы** для приоритезации.
18
18
 
19
+ ## Интерактивные вопросы
20
+
21
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
22
+ - Claude Code: используй `AskUserQuestion`.
23
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
24
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
25
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
26
+
19
27
  ## Этапы
20
28
 
21
29
  ### 1. Выбрать диапазон
package/docs/skills/eda-commit.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-commit
3
- description: Формирует коммит из незакоммиченных изменений в стиле проекта (по docs/rules.md или истории), коммитит без `--no-verify`. В конце спрашивает через AskUserQuestion: push (если есть remote) / merge в main + переключение + удаление ветки (если не в main) / ничего. Не правит логику кода, не пишет тесты — это `eda-execute` или `eda-fix-by-review`.
3
+ description: Формирует коммит из незакоммиченных изменений в стиле проекта (по docs/rules.md или истории), коммитит без `--no-verify`. В конце спрашивает интерактивно: push (если есть remote) / merge в main + переключение + удаление ветки (если не в main) / ничего. Не правит логику кода, не пишет тесты — это `eda-execute` или `eda-fix-by-review`.
4
4
  ---
5
5
 
6
6
  # Скил: Коммитер (eda-commit)
@@ -9,12 +9,21 @@ description: Формирует коммит из незакоммиченных
9
9
 
10
10
  ## Главные правила
11
11
 
12
- 1. **Все вопросы — через `AskUserQuestion`** (в Codex — короткий нумерованный список).
12
+ 1. **Интерактивные вопросы** — по разделу ниже.
13
13
  2. **Не правишь логику кода и не пишешь тесты.** Если на этапе коммита что-то не работает (упал hook, обнаружились сырые правки) — спроси через `AskUserQuestion`, не «допиливай» молча.
14
14
  3. **Pre-commit / pre-push hooks не отключай.** Никаких `--no-verify`. Hook упал → правим причину → новый коммит (не `--amend`).
15
15
  4. **Один логический коммит за вызов.** Если в diff видишь явно разные изменения — спроси через `AskUserQuestion`, разделить на несколько коммитов или коммитить одним.
16
16
  5. **Простой язык** в сообщениях пользователю.
17
17
 
18
+ ## Интерактивные вопросы
19
+
20
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
21
+ - Claude Code: используй `AskUserQuestion`.
22
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
23
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
24
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
25
+ - Для коммита это правило важнее требования довести операцию до конца: не делай push, merge, force-push, удаление ветки или исправление вне задачи вместо ответа пользователя.
26
+
18
27
  ## Этапы
19
28
 
20
29
  ### 1. Посмотреть состояние
package/docs/skills/eda-docs.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-docs
3
- description: Создаёт или обновляет три ключевых документа: `docs/rules.md` (максимально строгие правила для стека + предложения новых инструментов), `docs/arch.md` (архитектура проекта), `AGENTS.md` (описание проекта, стек, ссылки на документы и команды). Анализирует стек сам. Не правит код. Все вопросы — через AskUserQuestion.
3
+ description: Создаёт или обновляет три ключевых документа: `docs/rules.md` (максимально строгие правила для стека + предложения новых инструментов), `docs/arch.md` (архитектура проекта), `AGENTS.md` (описание проекта, стек, ссылки на документы и команды). Анализирует стек сам. Не правит код. Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Документатор (eda-docs)
@@ -9,13 +9,21 @@ description: Создаёт или обновляет три ключевых д
9
9
 
10
10
  ## Главные правила
11
11
 
12
- 1. **Все вопросы — через `AskUserQuestion`**.
12
+ 1. **Интерактивные вопросы** — по разделу ниже.
13
13
  2. **Не правишь код**, не ставишь пакеты, не меняешь конфиги. Только документы.
14
14
  3. **Максимальная строгость по умолчанию.** Все доступные strict-флаги, запреты «гибких» конструкций, обязательные типы / тесты / обработка ошибок. Если правило бьёт по продуктивности — пометь, но не выкидывай.
15
15
  4. **Можно предлагать инструменты, которых ещё нет в проекте**, если они стандартные для стека и повышают строгость. Не предлагай дубль уже установленному того же класса.
16
16
  5. **Существующие документы** не переписываем молча. Если файл уже есть — `AskUserQuestion`: переписать / дополнить / создать рядом.
17
17
  7. **Простой язык.** В правилах объясняй *почему*, не только *что*. **Таблицы** для перечислений.
18
18
 
19
+ ## Интерактивные вопросы
20
+
21
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
22
+ - Claude Code: используй `AskUserQuestion`.
23
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
24
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
25
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
26
+
19
27
  ## Этапы
20
28
 
21
29
  ### 1. Проанализировать проект
package/docs/skills/eda-execute.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-execute
3
- description: Исполняет план из docs/plans/ — правит код, пишет тесты к изменениям внутри каждого шага, в конце прогоняет полный сьют тестов и линтеры. Прогресс — чекбоксы в файле плана + журнал в `docs/executions/`; в конец плана дописывается ссылка на журнал. Не коммитит (это `eda-commit`), не делает ревью (это `eda-review`). Все вопросы — через AskUserQuestion.
3
+ description: Исполняет план из docs/plans/ — правит код, пишет тесты к изменениям внутри каждого шага, в конце прогоняет полный сьют тестов и линтеры. Прогресс — чекбоксы в файле плана + журнал в `docs/executions/`; в конец плана дописывается ссылка на журнал. Не коммитит (это `eda-commit`), не делает ревью (это `eda-review`). Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Исполнитель (eda-execute)
@@ -10,7 +10,7 @@ description: Исполняет план из docs/plans/ — правит ко
10
10
  ## Главные правила
11
11
 
12
12
  1. **Перед правкой кода** прочитай `docs/rules.md` и `docs/arch.md`, если есть. Это рамка проекта. Файлов нет — продолжай молча. Один раз в начале, не перечитывать на каждом шаге.
13
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex, если его нет — короткий нумерованный список).
13
+ 2. **Интерактивные вопросы** — по разделу ниже.
14
14
  3. **Не переформулируй план.** Шаг непонятен — спроси, не «доразрабатывай» молча.
15
15
  4. **Не коммитить, не пушить, не делать ревью.** Это другие скилы.
16
16
  5. **Идти целиком**, не делать паузы «для подтверждения». Останавливайся только если: тест упал, шаг противоречив, есть риск потерять данные, рискованная операция вне плана.
@@ -18,6 +18,15 @@ description: Исполняет план из docs/plans/ — правит ко
18
18
  7. **Простой язык** в сообщениях пользователю и вопросах. Термины — только если без них нельзя, и сразу с пояснением.
19
19
  8. **Таблицы для структурируемых данных** в журнале. Диаграммы — только если действительно есть что показать.
20
20
 
21
+ ## Интерактивные вопросы
22
+
23
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
24
+ - Claude Code: используй `AskUserQuestion`.
25
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
26
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
27
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
28
+ - Для выполнения кода это правило важнее требования идти целиком: не додумывай план, не делай рискованные операции и не правь чужие/несвязанные поломки вместо ответа пользователя.
29
+
21
30
  ## Этапы
22
31
 
23
32
  ### 1. Выбрать план
package/docs/skills/eda-fix-by-review.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-fix-by-review
3
- description: Применяет замечания из ревью (`docs/reviews/...`) к коду. Бесспорные («править обязательно») — правит сразу; «на усмотрение» — спрашивает через AskUserQuestion; «не править» — пропускает. После всех правок — полный прогон тестов и линтеров. Отчёт сохраняется в `docs/review-fixes/`. Не делает само ревью (это `eda-review`), не коммитит (это `eda-commit`). Все вопросы — через AskUserQuestion.
3
+ description: Применяет замечания из ревью (`docs/reviews/...`) к коду. Бесспорные («править обязательно») — правит сразу; «на усмотрение» — спрашивает интерактивно; «не править» — пропускает. После всех правок — полный прогон тестов и линтеров. Отчёт сохраняется в `docs/review-fixes/`. Не делает само ревью (это `eda-review`), не коммитит (это `eda-commit`). Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Исправитель по ревью (eda-fix-by-review)
@@ -10,7 +10,7 @@ description: Применяет замечания из ревью (`docs/review
10
10
  ## Главные правила
11
11
 
12
12
  1. **Перед правкой кода** прочитай `docs/rules.md` и `docs/arch.md`, если есть. Это рамка проекта. Один раз в начале.
13
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex — короткий нумерованный список).
13
+ 2. **Интерактивные вопросы** — по разделу ниже.
14
14
  3. **Не переформулируй замечания.** Применяй то, что написано в ревью. Если непонятно — спроси через `AskUserQuestion`.
15
15
  4. **Не делаешь само ревью и не коммитишь.** Только применяешь замечания и пишешь отчёт.
16
16
  5. **Логика по группам ревью:**
@@ -21,6 +21,15 @@ description: Применяет замечания из ревью (`docs/review
21
21
  7. **Финальный полный прогон тестов и линтеров — обязателен.** В конце, не на каждой правке.
22
22
  8. **Простой язык** в формулировках и сообщениях. **Таблицы** для отчёта о фиксах.
23
23
 
24
+ ## Интерактивные вопросы
25
+
26
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
27
+ - Claude Code: используй `AskUserQuestion`.
28
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
29
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
30
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
31
+ - Для исправления кода это правило важнее требования довести фиксы до конца: не применяй пункты «на усмотрение автора», не переформулируй замечания и не правь чужие/несвязанные поломки вместо ответа пользователя.
32
+
24
33
  ## Этапы
25
34
 
26
35
  ### 1. Выбрать ревью
package/docs/skills/eda-plan.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-plan
3
- description: Написание плана реализации через стандартный Plan Mode (Claude Code / Codex). Перед планированием подтягивает docs/rules.md, docs/arch.md, при необходимости — релевантное исследование. Согласованный план сохраняется в docs/plans/. Всегда проверяет план тремя параллельными моделями (слабая, средняя, мощная) на реалистичность, пропущенные шаги, нарушения правил и риски — главный планировщик сам решает, что добавить/убрать. В `strict` — ещё и кросс-CLI (Claude ↔ Codex). Все вопросы — через AskUserQuestion.
3
+ description: Написание плана реализации через стандартный Plan Mode (Claude Code / Codex). Перед планированием подтягивает docs/rules.md, docs/arch.md, при необходимости — релевантное исследование. Согласованный план сохраняется в docs/plans/. Всегда проверяет план тремя параллельными моделями (слабая, средняя, мощная) на реалистичность, пропущенные шаги, нарушения правил и риски — главный планировщик сам решает, что добавить/убрать. В `strict` — ещё и кросс-CLI (Claude ↔ Codex). Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Планировщик (eda-plan)
@@ -17,7 +17,7 @@ description: Написание плана реализации через ст
17
17
  ## Главные правила
18
18
 
19
19
  1. **Никаких правок кода.** Запись только в `docs/plans/`.
20
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex, если его нет — короткий нумерованный список).
20
+ 2. **Интерактивные вопросы** — по разделу ниже.
21
21
  3. **Plan Mode — главный инструмент.** Не изобретай свой формат планирования поверх — используй то, что Plan Mode даёт.
22
22
  4. **Не переформулируй запрос пользователя** перед Plan Mode. Уйдёт оригинал + ответы на уточнения. Своя цель/критерии разводят смысл.
23
23
  5. **План сохраняется в файл до любой верификации** — иначе ревьюеру нечего читать.
@@ -25,6 +25,14 @@ description: Написание плана реализации через ст
25
25
  7. **Диаграммы — желательно, не любой ценой.** Линейный план — диаграмма не нужна.
26
26
  8. **Таблицы > сплошной текст** для структурируемых данных.
27
27
 
28
+ ## Интерактивные вопросы
29
+
30
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
31
+ - Claude Code: используй `AskUserQuestion`.
32
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
33
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
34
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
35
+
28
36
  ## Этапы
29
37
 
30
38
  ### 1. Подтянуть контекст
@@ -38,7 +46,7 @@ description: Написание плана реализации через ст
38
46
  1. Дословный запрос пользователя.
39
47
  2. Пары «вопрос → ответ» из этапа 2.
40
48
  3. Ссылки на `docs/rules.md`, `docs/arch.md`, исследование (без пересказа — Plan Mode прочитает сам).
41
- 4. Инструкция: «все вопросы пользователю — только через `AskUserQuestion`, никаких догадок и свободного текста».
49
+ 4. Инструкция: «все вопросы пользователю — только по разделу "Интерактивные вопросы", никаких догадок и продолжения без ответа».
42
50
 
43
51
  Не выходи, пока пользователь не подтвердил план.
44
52
 
@@ -72,9 +80,19 @@ sources:
72
80
  | Claude Code (`Agent` tool) | `model: "haiku"` | `model: "sonnet"` | `model: "opus"` |
73
81
  | Codex CLI (`codex exec --model …`) | `gpt-5.4-mini` | `gpt-5.3-codex` | `gpt-5.5` |
74
82
 
75
- В Codex запускай три параллельных `codex exec --model <id>` через `Bash` с `&`. Если `gpt-5.5` недоступен (ограничение account/auth) — возьми `gpt-5.4` как мощную. Если какой-либо идентификатор отсутствует у тебя — возьми ближайший аналог того же тира из доступных в твоей версии Codex.
83
+ В Claude Code запускай три параллельных `Agent` tool с моделями из таблицы и передавай им промпты нужной глубины из таблицы ниже. В Codex запускай три параллельных `codex exec --model <id>` через `Bash` с `&`. Если `gpt-5.5` недоступен (ограничение account/auth) — возьми `gpt-5.4` как мощную. Если какой-либо идентификатор отсутствует у тебя — возьми ближайший аналог того же тира из доступных в твоей версии Codex.
84
+
85
+ Каждому передай путь к файлу плана, `docs/rules.md`, `docs/arch.md` (если есть), исследование из `sources.research` (если есть). Формулируй задание как содержательную проверку с глубиной чтения, указанной для тира модели ниже.
86
+
87
+ Глубина проверки зависит от модели:
88
+
89
+ | Модель | Что просить |
90
+ |---|---|
91
+ | Слабая | Быстро проверить план, правила, архитектуру и исследование; код смотреть только точечно, если без этого нельзя оценить риск. |
92
+ | Средняя | Проверить план по исследованию и прочитать релевантные файлы/контракты, которые прямо следуют из плана; найти пропущенные шаги, зависимости и тесты. |
93
+ | Мощная | Провести глубокую проверку: прочитать план, правила, архитектуру, исследование и релевантный код настолько глубоко, чтобы подтвердить реализуемость шагов, совместимость со смежным кодом, нужные тесты и отсутствие скрытых архитектурных рисков. |
76
94
 
77
- Каждому передай путь к файлу плана и `docs/rules.md`, `docs/arch.md` (если есть). Попроси: «прочитай план; проверь, что шаги **реалистичны и не ломают ничего вокруг** — нет ли пропущенных шагов, неучтённых зависимостей, нарушений правил и архитектуры, рисков для смежного кода, шагов без критерия готовности. Верни список `+ N | − N | ~ N: причина` без воды.»
95
+ Базовый формат ответа для всех: `+ N | − N | ~ N: причина`, без воды. Для мощной модели добавь явную инструкцию: «Если план ссылается на модуль, API, тесты или сценарий, открой соответствующие файлы и проверь фактическую структуру проекта.»
78
96
 
79
97
  Когда все три ответили — прочитай ответы, **сам реши**, что применять (не вставляй чужие пункты механически). Внеси правки в файл плана. Допиши в конец раздел:
80
98
 
@@ -92,11 +110,16 @@ sources:
92
110
  ### 6. Кросс-CLI — только в `strict`
93
111
  Обычный режим — пропусти этапы 6–7, иди на финал.
94
112
 
95
- В `strict`: отдай файл соседнему агенту через `Bash`:
113
+ В `strict`: отдай файл соседнему агенту через `Bash`. Если ты в Claude Code — запускай Codex CLI:
114
+
115
+ ```bash
116
+ codex exec "Прочитай $PLAN_FILE, docs/rules.md, docs/arch.md, связанное исследование из sources.research при наличии. Затем глубоко проверь план по релевантному коду: открой файлы, модули, API и тесты, которые следуют из плана, и оцени фактическую реализуемость. Критическое ревью на русском: пропущенные шаги, неучтённые зависимости, нарушения правил и архитектуры, скрытые риски, риски для смежного кода, недостающие тесты, шаги без критериев готовности. Список '- [тип] описание — что предлагаешь'." > "${PLAN_FILE%.md}_review.md"
117
+ ```
118
+
119
+ Если ты в Codex — запускай Claude CLI с теми же требованиями глубины:
96
120
 
97
121
  ```bash
98
- codex exec "Прочитай $PLAN_FILE. Критическое ревью на русском: пропущенные шаги, неучтённые зависимости, нарушения docs/rules.md и docs/arch.md, скрытые риски, шаги без критериев готовности. Список '- [тип] описание — что предлагаешь'." > "${PLAN_FILE%.md}_review.md"
99
- # Если ты Codex — claude -p вместо codex exec.
122
+ claude -p "Прочитай $PLAN_FILE, docs/rules.md, docs/arch.md, связанное исследование из sources.research при наличии. Затем глубоко проверь план по релевантному коду: открой файлы, модули, API и тесты, которые следуют из плана, и оцени фактическую реализуемость. Критическое ревью на русском: пропущенные шаги, неучтённые зависимости, нарушения правил и архитектуры, скрытые риски, риски для смежного кода, недостающие тесты, шаги без критериев готовности. Список '- [тип] описание — что предлагаешь'." > "${PLAN_FILE%.md}_review.md"
100
123
  ```
101
124
 
102
125
  Соседней CLI нет — `AskUserQuestion`: продолжать без ревью или прервать.
@@ -109,7 +132,7 @@ codex exec "Прочитай $PLAN_FILE. Критическое ревью на
109
132
 
110
133
  ## Чего НЕ делать
111
134
  - Править код, запускать миграции.
112
- - Задавать вопросы свободным текстом.
135
+ - Задавать вопросы без блокировки и продолжать работу до ответа.
113
136
  - Переформулировать запрос пользователя своими словами перед Plan Mode.
114
137
  - Пропускать сохранение файла плана.
115
138
  - Дублировать логику Plan Mode своим самописным форматом.
package/docs/skills/eda-research.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-research
3
- description: Глубокое исследование темы или задачи. Без правки кода. Все вопросы — через AskUserQuestion. Mermaid-диаграммы и markdown-таблицы — там где это даёт ясность. Итог сохраняется в docs/researches/. По умолчанию без кросс-ревью; кросс-ревью соседним агентом (Claude ↔ Codex) включается флагом `strict`.
3
+ description: Глубокое исследование темы или задачи. Без правки кода. Все вопросы — через интерактивный вопрос. Mermaid-диаграммы и markdown-таблицы — там где это даёт ясность. Итог сохраняется в docs/researches/. По умолчанию без кросс-ревью; кросс-ревью соседним агентом (Claude ↔ Codex) включается флагом `strict`.
4
4
  ---
5
5
 
6
6
  # Скил: Исследователь (eda-research)
@@ -17,12 +17,20 @@ description: Глубокое исследование темы или зада
17
17
  ## Главные правила
18
18
 
19
19
  1. **Никаких правок кода.** Запись только в `docs/researches/`.
20
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex, если его нет — короткий нумерованный список).
20
+ 2. **Интерактивные вопросы** — по разделу ниже.
21
21
  3. **Простой язык.** Термины — только когда без них нельзя, сразу с пояснением.
22
22
  4. **Каждое утверждение — со ссылкой** (`file.ext:42`, URL, коммит). Без ссылки — помечай как «гипотеза».
23
23
  5. **Диаграммы — желательно, не любой ценой.** Тема плоская — не выдумывай.
24
24
  6. **Таблицы > сплошной текст** для структурируемых данных.
25
25
 
26
+ ## Интерактивные вопросы
27
+
28
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
29
+ - Claude Code: используй `AskUserQuestion`.
30
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
31
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
32
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
33
+
26
34
  ## Этапы
27
35
 
28
36
  ### 1. Понять задачу
@@ -72,11 +80,18 @@ reviewer: <pending | none | claude | codex>
72
80
  ### 5. Кросс-ревью — только в `strict`
73
81
  Обычный режим — пропусти этапы 5–6, иди на финал. `reviewer: none`, `status: draft`.
74
82
 
75
- В `strict`: отдай файл соседнему агенту через `Bash`:
83
+ В `strict`: отдай файл соседнему агенту через `Bash` и сформулируй задание как глубокую проверку исследования по коду, документам и источникам.
84
+
85
+ Если ты в Claude Code — запускай Codex CLI:
86
+
87
+ ```bash
88
+ codex exec "Прочитай $RESEARCH_FILE, docs/rules.md, docs/arch.md при наличии и все источники, на которые ссылается исследование. Затем глубоко проверь исследование по релевантному коду и документам: открой файлы, модули, API, тесты и внешние источники, которые нужны для проверки фактов. Критическое ревью на русском: фактические ошибки, пропущенные риски, неподтверждённые утверждения, неточности диаграмм, неверные выводы, риски для будущего плана/реализации. Список '- [тип] описание — что предлагаешь'." > "${RESEARCH_FILE%.md}_review.md"
89
+ ```
90
+
91
+ Если ты в Codex — запускай Claude CLI с теми же требованиями глубины:
76
92
 
77
93
  ```bash
78
- codex exec "Прочитай $RESEARCH_FILE. Критическое ревью на русском: фактические ошибки, пропущенные риски, неподтверждённые утверждения, неточности диаграмм. Список '- [тип] описание — что предлагаешь'." > "${RESEARCH_FILE%.md}_review.md"
79
- # Если ты Codex — claude -p вместо codex exec.
94
+ claude -p "Прочитай $RESEARCH_FILE, docs/rules.md, docs/arch.md при наличии и все источники, на которые ссылается исследование. Затем глубоко проверь исследование по релевантному коду и документам: открой файлы, модули, API, тесты и внешние источники, которые нужны для проверки фактов. Критическое ревью на русском: фактические ошибки, пропущенные риски, неподтверждённые утверждения, неточности диаграмм, неверные выводы, риски для будущего плана/реализации. Список '- [тип] описание — что предлагаешь'." > "${RESEARCH_FILE%.md}_review.md"
80
95
  ```
81
96
 
82
97
  CLI нет — `AskUserQuestion`: продолжать без ревью или прервать.
@@ -89,7 +104,7 @@ CLI нет — `AskUserQuestion`: продолжать без ревью или
89
104
 
90
105
  ## Чего НЕ делать
91
106
  - Править код, запускать миграции, менять конфиги.
92
- - Задавать вопросы свободным текстом.
107
+ - Задавать вопросы без блокировки и продолжать работу до ответа.
93
108
  - Делать выводы без ссылок на источник.
94
109
  - Пропускать кросс-ревью молча в `strict`.
95
110
  - Сохранять отчёт куда-либо кроме `docs/researches/`.
package/docs/skills/eda-review.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-review
3
- description: Ревью изменений (незакоммиченный diff, ветка, PR, папка/файл). Формирует пронумерованные замечания, оценку 0–100, рекомендации «править / на усмотрение / не править». Сохраняет в docs/reviews/. Всегда проверяет своё же ревью тремя параллельными моделями (Sonnet, Haiku, Opus); кросс-CLI (Claude ↔ Codex) включается только флагом `strict`. После каждой проверки сам корректирует ревью. Не правит код — это `eda-fix-by-review`. Все вопросы — через AskUserQuestion.
3
+ description: Ревью изменений (незакоммиченный diff, ветка, PR, папка/файл). Формирует пронумерованные замечания, оценку 0–100, рекомендации «править / на усмотрение / не править». Сохраняет в docs/reviews/. Всегда проверяет своё же ревью тремя параллельными моделями (Sonnet, Haiku, Opus); кросс-CLI (Claude ↔ Codex) включается только флагом `strict`. После каждой проверки сам корректирует ревью. Не правит код — это `eda-fix-by-review`. Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Ревьюер (eda-review)
@@ -17,13 +17,21 @@ description: Ревью изменений (незакоммиченный diff,
17
17
  ## Главные правила
18
18
 
19
19
  1. **Перед ревью** прочитай `docs/rules.md` и `docs/arch.md`, если есть. Замечания должны опираться на правила проекта, а не на твои общие представления.
20
- 2. **Все вопросы — через `AskUserQuestion`** (в Codex — короткий нумерованный список).
20
+ 2. **Интерактивные вопросы** — по разделу ниже.
21
21
  3. **Не правишь код.** Только ревью. Запись только в `docs/reviews/`.
22
22
  4. **Мета-ревью тремя моделями — обязательно**, без флага. Кросс-CLI — только в `strict`.
23
23
  5. **Главный ревьюер — ты.** Мета-ревьюеры дают подсказки; решение — добавить, убрать или оставить пункт — за тобой. Не вставляй чужие пункты механически.
24
24
  6. **Простой язык** в формулировках замечаний и рекомендаций. Технические термины — только если без них нельзя, и сразу с пояснением.
25
25
  7. **Таблицы для замечаний.** Сплошной текст — только для оценки и общего вывода.
26
26
 
27
+ ## Интерактивные вопросы
28
+
29
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
30
+ - Claude Code: используй `AskUserQuestion`.
31
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
32
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
33
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
34
+
27
35
  ## Этапы
28
36
 
29
37
  ### 1. Выбрать вход и прочитать контекст
@@ -74,9 +82,19 @@ meta_reviewers: []
74
82
  | Claude Code (`Agent` tool) | `model: "haiku"` | `model: "sonnet"` | `model: "opus"` |
75
83
  | Codex CLI (`codex exec --model …`) | `gpt-5.4-mini` | `gpt-5.3-codex` | `gpt-5.5` |
76
84
 
77
- В Codex — три параллельных `codex exec --model <id>` через `Bash` с `&`. Если `gpt-5.5` недоступен (ограничение account/auth) — возьми `gpt-5.4` как мощную. Если какой-либо идентификатор отсутствует у тебя — возьми ближайший аналог того же тира из доступных в твоей версии Codex.
85
+ В Claude Code запускай три параллельных `Agent` tool с моделями из таблицы и передавай им промпты нужной глубины из таблицы ниже. В Codex запускай три параллельных `codex exec --model <id>` через `Bash` с `&`. Если `gpt-5.5` недоступен (ограничение account/auth) — возьми `gpt-5.4` как мощную. Если какой-либо идентификатор отсутствует у тебя — возьми ближайший аналог того же тира из доступных в твоей версии Codex.
86
+
87
+ Каждому дай путь к файлу ревью, указание на `$TARGET`, `docs/rules.md`, `docs/arch.md` (если есть), связанный план/research (если ревью на них ссылается). Формулируй задание как содержательную проверку с глубиной чтения, указанной для тира модели ниже.
88
+
89
+ Глубина проверки зависит от модели:
90
+
91
+ | Модель | Что просить |
92
+ |---|---|
93
+ | Слабая | Быстро проверить ревью, diff и правила; код смотреть только точечно, если без этого нельзя оценить пункт. |
94
+ | Средняя | Проверить ревью по diff и прочитать релевантные файлы/контракты, которые прямо следуют из изменений; найти пропущенные или неверные замечания. |
95
+ | Мощная | Провести глубокую проверку: прочитать ревью, diff, правила, архитектуру, связанный план/research и релевантный код настолько глубоко, чтобы подтвердить корректность замечаний, найти пропущенные баги, риски для смежного кода и недостающие тесты. |
78
96
 
79
- Каждому дай путь к файлу ревью + указание на `$TARGET` и попроси: «прочитай ревью и diff; предложи, какие пункты добавить (которых не хватает), какие убрать (избыточные/неверные), какие переформулировать. Список `+ N | − N | ~ N: причина`. Без воды.»
97
+ Базовый формат ответа для всех: `+ N | − N | ~ N: причина`, без воды. Для мощной модели добавь явную инструкцию: «Если ревью или diff ссылаются на модуль, API, тесты или сценарий, открой соответствующие файлы и проверь фактическое поведение проекта.»
80
98
 
81
99
  Когда все три ответили: прочитай ответы, **сам реши**, что применять. Внеси правки в файл ревью. В разделе `## Изменения после мета-ревью` запиши:
82
100
 
@@ -92,10 +110,16 @@ meta_reviewers: []
92
110
  ### 4. Кросс-CLI: отдать соседнему агенту — только в `strict`
93
111
  Обычный режим — пропусти этап 4, иди на финал. `status: meta-reviewed` оставь как есть.
94
112
 
95
- В `strict`: если ты Claude → отдай Codex, и наоборот. Передай путь к файлу ревью и `$TARGET`:
113
+ В `strict`: отдай файл соседнему агенту через `Bash`. Если ты в Claude Code — запускай Codex CLI:
114
+
115
+ ```bash
116
+ codex exec "Прочитай $REVIEW_FILE, $TARGET, docs/rules.md, docs/arch.md, связанный план/research при наличии. Затем глубоко проверь ревью по релевантному коду: открой файлы, модули, API и тесты, которые следуют из diff и замечаний, и оцени фактическую корректность. Мета-ревью на русском: какие пункты добавить, убрать, переформулировать; какие баги, риски для смежного кода и недостающие тесты пропущены. Список '+ N | − N | ~ N: причина'." > "${REVIEW_FILE%.md}_cli_meta.md"
117
+ ```
118
+
119
+ Если ты в Codex — запускай Claude CLI с теми же требованиями глубины:
96
120
 
97
121
  ```bash
98
- codex exec "Прочитай $REVIEW_FILE и $TARGET. Мета-ревью на русском: какие пункты добавить, убрать, переформулировать. Список '+ N | − N | ~ N: причина'." > "${REVIEW_FILE%.md}_cli_meta.md"
122
+ claude -p "Прочитай $REVIEW_FILE, $TARGET, docs/rules.md, docs/arch.md, связанный план/research при наличии. Затем глубоко проверь ревью по релевантному коду: открой файлы, модули, API и тесты, которые следуют из diff и замечаний, и оцени фактическую корректность. Мета-ревью на русском: какие пункты добавить, убрать, переформулировать; какие баги, риски для смежного кода и недостающие тесты пропущены. Список '+ N | − N | ~ N: причина'." > "${REVIEW_FILE%.md}_cli_meta.md"
99
123
  ```
100
124
 
101
125
  Соседней CLI нет — `AskUserQuestion`: завершить как есть или прервать.
@@ -119,6 +143,6 @@ codex exec "Прочитай $REVIEW_FILE и $TARGET. Мета-ревью на
119
143
  - Пропускать мета-ревью тремя моделями (это часть обычного режима, не под флагом).
120
144
  - Пропускать кросс-CLI молча в `strict` (если соседней CLI нет — спроси через `AskUserQuestion`).
121
145
  - Вставлять чужие предложения механически — каждое решение принимай ты.
122
- - Задавать вопросы свободным текстом.
146
+ - Задавать вопросы без блокировки и продолжать работу до ответа.
123
147
  - Сохранять ревью куда-либо кроме `docs/reviews/`.
124
148
  - Оформлять замечания сплошным текстом — только таблица.
package/docs/skills/eda-send-review.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: eda-send-review
3
- description: Отправляет ревью из `docs/reviews/...` на GitHub PR через `gh` — как review (comment/approve/request-changes) или как обычный комментарий. Целевой PR определяется автоматически по текущей ветке; если PR нет — предлагает создать. После отправки в конец файла ревью дописывает ссылку на PR-комментарий. Не правит код, не делает само ревью. Все вопросы — через AskUserQuestion.
3
+ description: Отправляет ревью из `docs/reviews/...` на GitHub PR через `gh` — как review (comment/approve/request-changes) или как обычный комментарий. Целевой PR определяется автоматически по текущей ветке; если PR нет — предлагает создать. После отправки в конец файла ревью дописывает ссылку на PR-комментарий. Не правит код, не делает само ревью. Все вопросы — через интерактивный вопрос.
4
4
  ---
5
5
 
6
6
  # Скил: Отправитель ревью (eda-send-review)
@@ -9,11 +9,20 @@ description: Отправляет ревью из `docs/reviews/...` на GitHub
9
9
 
10
10
  ## Главные правила
11
11
 
12
- 1. **Все вопросы — через `AskUserQuestion`** (в Codex — короткий нумерованный список).
12
+ 1. **Интерактивные вопросы** — по разделу ниже.
13
13
  2. **Не правишь код, не делаешь само ревью.** Только переупаковка и отправка.
14
14
  3. **Никаких самостоятельных оценок.** Тип отправки (comment / approve / request-changes) определяется на основе ревью + подтверждается пользователем.
15
15
  4. **Простой язык.** В сообщениях пользователю и комментарии PR без лишних терминов.
16
16
 
17
+ ## Интерактивные вопросы
18
+
19
+ Когда инструкция говорит `AskUserQuestion`, это означает блокирующий интерактивный вопрос.
20
+ - Claude Code: используй `AskUserQuestion`.
21
+ - Codex interactive: если доступен `request_user_input`, используй его. Если tool недоступен, задай один короткий вопрос в чат, дай варианты 1–3, напиши «Ответь номером или своим вариантом. Я продолжу только после ответа.» и остановись.
22
+ - Codex exec / неинтерактивный запуск: не задавай вопросы и не пытайся читать stdin. Если без ответа нельзя безопасно продолжать, заверши работу со статусом `blocked: нужен ответ пользователя`, перечисли вопросы и варианты, не выполняй рискованные действия.
23
+ - Не запускай команды, которые ждут интерактивного ввода в терминале; перед такими командами спроси в хост-интерфейсе или остановись с `blocked`.
24
+ - Для отправки ревью это правило важнее продолжения: не создавай PR, не отправляй approve/request-changes и не меняй тип отправки вместо ответа пользователя.
25
+
17
26
  ## Этапы
18
27
 
19
28
  ### 1. Проверить инструменты
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gian-tiaga/eda",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "description": "Набор скилов eda-* для Claude Code и Codex CLI: research, plan, execute, review, fix, send-review, commit, docs, automate",
5
5
  "type": "module",
6
6
  "bin": {