Описание
Spec-first Agentic Development представляет собой структурированный подход к работе с AI-кодирующими агентами, обеспечивая, чтобы каждое изменение инициировалось четко определенной и проверенной спецификацией. Эта методология направлена на повышение надежности и поддерживаемости кода, разработанного AI-агентами, путем интеграции человеческого контроля и автоматических проверок на протяжении всего жизненного цикла разработки.
Читать далее
Основной принцип заключается в том, что каждая задача разработки начинается с написанной спецификации, хранящейся в репозитории. Эта спецификация описывает цель, соответствующие факты (включая ссылки на файлы и строки), шаги, которые необходимо предпринять, и точные критерии «готовности». Прежде чем будет написан какой-либо код, новый рецензент проверяет спецификацию на соответствие существующей кодовой базе, чтобы подтвердить ее точность и осуществимость. После одобрения AI-агент приступает к разработке функции на своей изолированной ветке и рабочем дереве. Финальный коммит может быть добавлен в основной репозиторий только после успешного прохождения всех предопределенных проверок и тестов, что обеспечивает качество кода и соответствие спецификации.
Эта система значительно отличается от традиционного «кодирования по настроению», заменяя спонтанные подсказки проверенной, постоянной спецификацией. Она фиксирует каждое решение, принятое агентом, с его обоснованием, предоставляя четкий след аудита и уменьшая необходимость в документации после разработки. Спецификации разработаны для того, чтобы уточнить намерения и архитектуру, а не быть чрезмерно точными генераторами кода, при этом тесты и контроль коммитов обеспечивают необходимую точность. Старые спецификации рассматриваются как неизменяемые записи изменений, аналогично коммитам, и не обновляются, что предотвращает устаревание.
Spec-first Agentic Development поддерживает параллельную разработку, позволяя нескольким агентам работать над различными спецификациями одновременно, используя уникальные идентификаторы веток и рабочих деревьев. Процесс не прерывается, так как проверенные спецификации заранее отвечают на открытые вопросы, позволяя агентам строить непосредственно по критериям готовности. Весь рабочий процесс структурирован, одна спецификация соответствует одной ветке и одному коммиту, упрощая запросы на слияние и обеспечивая согласованность. Состояние сохраняется в `context.yaml`, что делает работу возобновляемой даже после перезапусков.
Метод, шаблоны и плагин Claude Code лицензированы по MIT, что делает их бесплатным решением. Хотя плагин Claude Code автоматизирует бухгалтерский учет и функции контроля, методология также может быть принята с другими агентами, такими как Codex, Cursor или Copilot, следуя `AGENTS.md` и устанавливая хук git commit-msg для контроля коммитов. Этот подход был разработан и усовершенствован в процессе создания Agent Smith, открытой программной фабрики, демонстрируя его практическое применение и эффективность.
- КатегорияAI-помощники для программирования
- Модель ценообразованияБесплатно
- РазвёртываниеОблако
- ПлатформыВеб
Основные функции Spec-first Agentic Development
Разработка, основанная на спецификациях для AI-кодирующих агентов
Проверенные спецификации, проверенные на соответствие коду перед разработкой
Изолированные рабочие деревья для каждой задачи разработки
Контроль коммитов, требующий успешного прохождения всех проверок
Постоянные спецификации, хранящиеся в репозитории
Логирование решений с обоснованием для отслеживаемости
Поддержка параллельной разработки с уникальными идентификаторами веток
Возобновляемые рабочие процессы с состоянием, хранящимся в context.yaml
Метод, шаблоны и плагин Claude Code с лицензией MIT
Совместимость с Codex, Cursor, Copilot и терминалом
Хук git commit-msg для обеспечения контроля коммитов
Автоматизированная проверка доказательств для цитирования спецификаций
Структурированные запросы на слияние для одной или серии спецификаций
Контексты и правила, генерируемые из существующей кодовой базы
Не требуется ручной код для процесса сборки Agent Smith
Как использовать Spec-first Agentic Development?
Установите плагин/хук: Установите плагин Claude Code или хук git commit-msg в вашем проекте.
Запустите проект: Выполните /spec-first:bootstrap-project для генерации контекстов и правил из вашего существующего кода.
Создайте спецификацию: Определите новую задачу с целью, шагами, фактами и критериями готовности, используя навык create-spec.
Проверьте спецификацию: Попросите нового рецензента проверить спецификацию на соответствие коду для подтверждения точности и осуществимости.
Примените спецификацию: Агент разрабатывает спецификацию на своей ветке и рабочем дереве, следуя правилам проекта.
Предоставьте спецификацию: Зафиксируйте изменения через контроль, убедившись, что все проверки пройдены, и откройте запрос на слияние.
Предоставьте серию: Для более крупных изменений используйте /spec-first:deliver-series для управления и предоставления нескольких взаимозависимых спецификаций.
Варианты использования Spec-first Agentic Development
- Разработка кода AI-агентом
- Обеспечение качества кода
- Управление сложными проектами
- Улучшение отслеживаемости кода
- Упрощение код-ревью
- Автоматизация рабочих процессов разработки
- Введение новых разработчиков
- Интеграция с существующими инструментами
