4.5 KiB
Фиксация в репозитории документов диагностики бэкап-сервера
Цель
Зафиксировать в системе контроля версий два документа проведённой диагностики резервного сервера Gitea — спеку пробы и её рабочий план — чтобы результат работы сохранился в истории репозитория и в резервных копиях. Это документально-фиксирующая задача: содержимое файлов уже готово, требуется только аккуратно занести ровно эти два файла в индекс, создать коммит и отправить его в удалённый репозиторий. Никакие другие файлы не затрагиваются.
Контракт фиксации
Фиксируются ровно два файла:
docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md— спека пробы состояния сервера;docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md— её рабочий план.
Порядок: (1) занести оба файла в индекс командой git add с явным перечислением путей —
никаких массовых add -A, чтобы не зацепить посторонние изменения рабочего дерева; (2) создать
коммит с описательным сообщением без круглых скобок и с трейлером соавторства; (3) отправить
коммит в удалённый репозиторий командой git push. Каждая команда — одиночная, без цепочек.
Блок проверенного контекста ниже цитирует заголовки обоих фиксируемых файлов — это подтверждает, что файлы существуют и содержат ожидаемые разделы, то есть фиксируется именно подготовленная работа, а не пустышки.
Крайние случаи
- Отправка отклонена удалённым. Если
git pushпадёт с ошибкой доступа (по прежним записям внешний GitHub-аккаунт мог быть заблокирован, код 403), коммит всё равно остаётся в локальной истории, а полная копия истории хранится на резервном Gitea-сервере. Тогда отправку повторяют позже либо через резервный канал; данные не теряются. - Посторонние изменения в дереве. В рабочем дереве есть прочие незакоммиченные файлы; явное
перечисление путей в
git addи изоляция коммита по этим же путям гарантируют, что в коммит попадут только два целевых документа.
Критерий успеха
Задача завершена, когда создан коммит, содержащий ровно два перечисленных файла, с корректным сообщением, и предпринята попытка отправки в удалённый репозиторий. Результат отправки (успех или отказ доступа) сообщается владельцу как есть, без приукрашивания.
Конвенция оформления
Сообщение коммита — без круглых скобок, с обязательным трейлером
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>. Отчёт владельцу — простым языком: что
закоммичено и прошла ли отправка.
[
{"id":"vc1","kind":"EXTRACTED","ref":"docs/superpowers/specs/2026-06-16-gitea-backup-status-probe.md","anchor":"Контракт пробы"},
{"id":"vc2","kind":"EXTRACTED","ref":"docs/superpowers/plans/2026-06-16-gitea-backup-status-probe-v3.md","anchor":"три независимых read-only сигнала"}
]