# github-agent

Пакет для агента, который ведёт репозиторий и вики на GitHub: проверяет гигиену,
собирает и публикует вики, выпускает версии, следит за метаданными. Python 3, только
стандартная библиотека, ни одной внешней зависимости.

## С чего начать

| Шаг | Страница | Зачем |
|---|---|---|
| 1 | [Зачем это нужно](01-Why.ru) | какие дефекты ловятся и почему глазами их не видно |
| 2 | [Установка](02-Install.ru) | поставить пакет и проверить его тестами |
| 3 | [Контракты файлов](03-Repository-Contract.ru) | что именно проверяется в README, AGENTS.md, CHANGELOG |
| 4 | [Работа с вики](04-Wiki-Workflow.ru) | сборка, проверка и публикация без потери чужих страниц |
| 5 | [Выпуск версии](05-Release.ru) | перенос Unreleased, ссылки сравнения, текст релиза |
| 6 | [Ловушки платформы](06-Traps.ru) | пятнадцать мест, где GitHub ведёт себя не так, как ждёшь |
| 7 | [Импорт в другой агент](07-Import.ru) | AutoClaw2, HARNESS, SagaAI |

## Что делает пакет

| Задача | Команда |
|---|---|
| Аудит репозитория | `ghagent.py audit .` |
| Документы и ссылки | `ghagent.py doc --root .` |
| Вики: сборка, проверка, публикация | `ghagent.py wiki build`, `verify`, `publish --push` |
| Журнал изменений | `ghagent.py changelog check`, `release`, `suggest` |
| Метаданные | `ghagent.py meta suggest`, `apply` |
| Установка навыка | `ghagent.py install`, `verify-install` |

Все команды возвращают код: `0` — чисто, `1` — есть ошибки, `2` — ошибка вызова.

## Ссылки

- [Репозиторий](https://github.com/paulmann/github-agent)
- [Релизы](https://github.com/paulmann/github-agent/releases)
- [Issues](https://github.com/paulmann/github-agent/issues)

> [!TIP]
> Эта вики собрана и опубликована самим пакетом: `wiki build`, `wiki verify`,
> `wiki publish --push`. Если страница открывается, а ссылка в ней ведёт на соседнюю —
> значит проверка работает.