GitHub Projects для AI-агентов

источник ↗ · 8 сентября 2026, 19:02

Практическое руководство по организации работы AI-агентов через GitHub Projects, Issue Fields, автоматизации и Agentic Workflows.

privacy

Эта заметка участвует в semantic memory.

AI Summary

Короткий обзор сути: GitHub Projects превращается в журнал состояния для AI-агентов, где issue хранит постановку задачи, статус показывает этап выполнения, а связь issue-PR сохраняет трассируемость изменений.

🔑 Ключевые факты

Четыре опоры процесса: issue с критериями приёмки, поле статуса, связь issue-PR, отдельные представления для агента и человека.
Минимальная схема полей: Backlog → Todo → In Progress → In Review → Done.
Issue Fields (single-select, текст, число, дата) действуют на уровне организации и видны во всех репозиториях.
Agentic Workflows позволяют описывать задачи на естественном языке в Markdown; YAML frontmatter задаёт триггеры и разрешения.
Стоимость: AI Credits (1 AIC = $0.01), лимит по умолчанию 1000 AIC на запуск.

📌 Важные детали

Нельзя менять Assignees, Labels, Milestone через updateProjectV2ItemFieldValue — только через мутации issue/PR.
Для GraphQL нужны отдельные запросы: сначала addProjectV2ItemById, потом updateProjectV2ItemFieldValue.
Agentic Workflows находятся в public preview (на 7 сентября 2026).
Ограничения безопасности: репозиторий только для чтения, запись через safe-outputs, секреты вне среды агента.
Типичные ошибки: отсутствие критериев приёмки, слишком крупные задачи, попытка изменить системные поля через Projects API.

💡 Вывод и значение

Начать с автоматического добавления задач и перевода закрытых элементов в Done.
Провести сквозной тест: создать issue → перевести в In Progress → открыть PR → закрыть/смержить → проверить Done.
Хранить токены только в GitHub Actions Secrets.
Для сложных задач использовать AGENTS.md / SESSION_NOTES как проектную память.
Следующий материал: «AGENTS.md / SESSION_NOTES — проектная память для coding-агентов».