Files
dotfiles/agents/.agents/skills/codex-subagent-playbook/handoffs/20260713-1411-review-optics-and-sync.md
T
Dmitriy Dementiev baac159189 docs(codex-playbook): добавлен handoff по оптике ревью
- Зачем:
  - следующей сессии нужен компактный контекст решений и незавершённой синхронизации.
- Что:
  - сохранены ссылки на действующие договоры скилла и триаж ревью.
  - описана гонка удалённой ветки и безопасный порядок последующего merge.
- Проверка:
  - git diff --check и проверка локальных ссылок handoff.
2026-07-13 14:12:43 +03:00

3.9 KiB
Raw Blame History

Handoff: оптика ревью и синхронизация

Назначение

Продолжить полевую проверку codex-subagent-playbook после согласования тонкого координатора, файлового канала и ревью высокоуровневых документов. Действующий договор находится в SKILL.md, механика ревью — в review-and-triage.md, текущая маршрутизация — в roles.md.

Зафиксированное состояние

  • 6cc1b26 пересобрал скилл вокруг оптики тонкого мастера.
  • 70b18b9 убрал shell-зависимые и конвейерные допущения из шаблонов.
  • 02a98df закрепил ревью на уровне самого документа: открытые детали реализации не мешают APPROVED, существенный отложенный риск можно вернуть как неблокирующее соображение.
  • quick_validate.py, git diff --check и локальные Markdown-ссылки проходили после изменений.

Оптика триажа ревью

Находки ревьюера — сигналы о возможных слабых местах, а не руководство к действию. Перед правкой проверять, реальна ли проблема в рамках замысла и не превращает ли предложенное решение оптику в обязательный конвейер.

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

Незавершённая синхронизация

Первый git pull --no-rebase origin master вернул Already up to date. Следующий git push origin master был отклонён: удалённый master успел перейти с a4985b3 на 9c047f9.

Следующему агенту:

  1. Закоммитить этот handoff отдельным Conventional Commit.
  2. Выполнить git fetch origin и изучить новые удалённые коммиты.
  3. Слить origin/master обычным merge, сохранив локальный замысел и удалённые изменения. Не выбирать сторону конфликта целиком без чтения.
  4. Повторить проверки скилла и отправить master в origin.

В рабочем дереве есть посторонние неотслеживаемые каталоги скиллов и .skill-lock.json. Они не относятся к этой работе; не добавлять и не удалять их.

Suggested skills

  • $codex-subagent-playbook — применять и оценивать текущую оптику.
  • $writing-great-skills — проверять ясность и отсутствие скрытого процесса.
  • $conventional-commits — формировать сообщения следующих коммитов.
  • $code-review — только для нового независимого обзора по явной потребности.