From ac4fdd563797ccd3efcab7bdf4a76271ad679c8b Mon Sep 17 00:00:00 2001 From: Dmitry Afonasenko Date: Wed, 14 Oct 2026 13:37:52 +0500 Subject: [PATCH] feat(kit): add focused parallel work skill --- .agents/skills/aek-parallel-work/SKILL.md | 16 ++++++++++++++++ README.md | 3 ++- personal/AGENTS.md | 1 + scripts/check.py | 1 + 4 files changed, 20 insertions(+), 1 deletion(-) create mode 100644 .agents/skills/aek-parallel-work/SKILL.md diff --git a/.agents/skills/aek-parallel-work/SKILL.md b/.agents/skills/aek-parallel-work/SKILL.md new file mode 100644 index 0000000..06d2bc1 --- /dev/null +++ b/.agents/skills/aek-parallel-work/SKILL.md @@ -0,0 +1,16 @@ +--- +name: aek-parallel-work +description: "Coordinate multiple agents on independent subtasks with clear ownership and integrated validation. Use for parallel implementation or independent investigation and review; skip small or tightly coupled tasks." +--- + +# Координация нескольких агентов + +Используй доступные средства делегирования в пределах полномочий задачи. До запуска оцени независимость частей и ожидаемую пользу с учётом передачи контекста, проверки и объединения. Если работа мала, тесно связана или делегирование недоступно, выполни её последовательно. Подключение навыка не требует запуска агентов, установки инструментов или изменения настроек. + +- **За общий результат отвечает один координатор.** Основной агент держит цель, границы и краткий план, распределяет работу, разрешает противоречия и принимает результат. Число исполнителей выбирай по независимым задачам и доступным ресурсам; не назначай фиксированные модели и роли без необходимости. Исполнитель не создаёт новых агентов без решения координатора. +- **У каждой подзадачи есть проверяемый договор.** Передай цель, нужный контекст и исходное состояние, разрешённые файлы или ресурсы, зависимости, критерии готовности и способ проверки. Явно различай исследование только для чтения и разрешение на правки. Делегирование не расширяет полномочия на commit, публикацию, данные и внешние действия. При общей среде сообщи исполнителям, что чужие изменения нельзя откатывать. +- **Параллельная запись имеет границы.** Для независимых правок используй отдельные worktree либо непересекающиеся области с явным владельцем. Общие файлы и операции Git в одном checkout оставь одному ответственному; зависимую работу начинай после согласования нужного контракта. Worktree не изолирует базы данных, порты, секреты и внешние сервисы: раздели используемые ресурсы либо выполняй затрагивающие их действия последовательно. При конфликте границ останови конфликтующие записи и уточни разделение. +- **Передача результата завершает владение работой.** Исполнитель возвращает выводы или изменения с указанием их расположения, выполненные проверки, ограничения и блокеры. При блокере он не расширяет задачу самостоятельно. До передачи области другому исполнителю или интеграции убедись, что прежний исполнитель больше её не меняет. Используй доступные уведомления и ожидание вместо частого опроса; при смене цели сообщи об этом затронутым исполнителям. +- **Объединённый результат проверяет координатор.** Изучи фактические изменения и доказательства проверок, разреши расхождения с требованиями и проверь взаимодействие частей после объединения. Отчёт исполнителя и зелёные отдельные тесты не подтверждают общий сценарий. Принятые проверки повторяй только при изменении проверяемого состояния, новом риске или противоречащем результате. Если часть работы не проверена, назови её явно. + +Не добавляй отдельный планировщик, обязательные отчёты или постоянную документацию ради делегирования. Не обещай ускорение и экономию без измерений: качество результата, время, расход токенов и вмешательства пользователя оценивай отдельно, а недоступные показатели оставляй неизвестными. diff --git a/README.md b/README.md index 13bf046..a3d6849 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Agent Engineering Kit -Engineering guidelines for Codex: short everyday instructions and focused skills for data safety, code changes, and user interfaces. +Engineering guidelines for Codex: short everyday instructions and focused skills for data safety, code changes, user interfaces, and parallel agent work. ## Get started @@ -18,6 +18,7 @@ The instructions are written in Russian. Adapt them to your language and project | [aek-data-safety](.agents/skills/aek-data-safety/SKILL.md) | Storage, import/export, migrations, sync, retries, and recovery. | | [aek-change-safety](.agents/skills/aek-change-safety/SKILL.md) | Module boundaries, public contracts, behavior replacement or removal, and recurring defects. | | [aek-user-interface](.agents/skills/aek-user-interface/SKILL.md) | New or substantial GUI changes, user flows, action states, and layout. | +| [aek-parallel-work](.agents/skills/aek-parallel-work/SKILL.md) | Independent subtasks, agent ownership, and validation after integration; skip small or tightly coupled work. | Codex reads global and project `AGENTS.md` instructions at the start of a session. It first sees skill names and descriptions, then reads a skill's full instructions when it selects that skill. A link alone does not load a file. Automatic skill selection is not guaranteed: select a skill in the app or name it explicitly, for example `$aek-data-safety Change the export format`. Skills keep project-specific formats and decisions in the project; they do not replace them. See the official [AGENTS.md guide](https://learn.chatgpt.com/docs/agent-configuration/agents-md) and [skills guide](https://learn.chatgpt.com/docs/build-skills). diff --git a/personal/AGENTS.md b/personal/AGENTS.md index d4153b8..34350ca 100644 --- a/personal/AGENTS.md +++ b/personal/AGENTS.md @@ -5,5 +5,6 @@ - При создании интерфейса выбирай композицию по задачам пользователя и особенностям продукта. Используй привычные элементы, когда они уместны, без механического повторения шаблона. Сохраняй существующую визуальную систему, если нет оснований её менять. - Не создавай документы, процессы и инфраструктуру без конкретной пользы. До значимого изменения читай действующие решения затронутой области, а не всю историю проекта. Изменённое долгосрочное решение кратко сохраняй в одном существующем подходящем месте: что выбрано, зачем и где смотреть. Проектные особенности не превращай в общие правила; временное исследование не становится постоянной документацией. Приватному контексту нужен доступный и восстанавливаемый источник: одно игнорирование в Git его не защищает. - Обратимые локальные решения принимай самостоятельно. Уточняй выбор, если он существенно меняет результат, данные, совместимость или стоимость поддержки. Выполни задачу, проверь результат и остановись; не расширяй её до незапрошенного аудита или рефакторинга. +- До значимого изменения определи ожидаемый результат, границы задачи и способ проверки по требованиям и действующим контрактам. Для многошаговой работы держи краткий актуальный план; отдельный документ нужен только тогда, когда помогает продолжению или передаче задачи. - Сохраняй чужие незакоммиченные изменения, приватный контекст и файлы с неизвестным назначением. Самостоятельно очищай только созданные тобой для текущей задачи воспроизводимые временные файлы и результаты сборки, проверив состав и границы удаления. Commit, push, merge, публикация, удаление пользовательских или уникальных данных и другие внешние или труднообратимые действия требуют явных полномочий. Для удаления значимых данных и миграций нужна проверенная возможность восстановления. Массовая очистка непроверенных каталогов не разрешена. - Отличай проверенные факты от предположений. Кратко сообщай результат и существенные ограничения проверки; не выдавай подготовку или локальный тест за подтверждённую работу в реальной среде. diff --git a/scripts/check.py b/scripts/check.py index f2ab24f..394d536 100644 --- a/scripts/check.py +++ b/scripts/check.py @@ -12,6 +12,7 @@ ".agents/skills/aek-data-safety/SKILL.md", ".agents/skills/aek-change-safety/SKILL.md", ".agents/skills/aek-user-interface/SKILL.md", + ".agents/skills/aek-parallel-work/SKILL.md", )