Spec Kit пишет документы.В DotMD вы их проверяете.

Что такое GitHub Spec Kit

Spec Kit — набор инструментов GitHub с открытым кодом для разработки через спецификации. Он не заменяет вашего агента. Он добавляет программу командной строки specify, которая настраивает проект, и набор команд, которые вы запускаете в чате агента. Пишет агент; Spec Kit даёт ему шаги и структуру.

Он поддерживает многих агентов, включая Claude Code, Codex CLI и Cursor. Полный список — на странице интеграций Spec Kit.

Установка и инициализация

Нужны Python 3.11 или новее и uv. Затем:

uv tool install specify-cli
specify init my-project --integration claude

Флаг --integration принимает ключ вашего агента: claude для Claude Code, codex для Codex CLI, cursor-agent для Cursor. Ключ любого другого агента указан на странице Spec Kit.

Команды по порядку

Вы вводите их в чате агента, а не в терминале:

1. /speckit-constitution
2. /speckit-specify: пишет spec.md.
3. /speckit-plan: пишет plan.md.
4. /speckit-tasks: пишет tasks.md.
5. /speckit-implement: строит по задачам.
6. /speckit-converge

Написание команды зависит от агента: у одних /speckit.specify, у других дефис или $. Spec Kit объясняет формы для каждого агента в заметках о вызове команд.

Проверяйте каждый шаг в DotMD

Spec Kit просит проверить каждый результат, прежде чем продолжать. DotMD делает из этого настоящее ревью, а не беглый просмотр в терминале.

1. Откройте проект

   Нажмите ⌘O и выберите папку проекта. Файлы, которые пишет Spec Kit, появляются в боковой панели по мере создания, отрисованные с заголовками, списками и таблицами.

2. Прокомментируйте точную строку

   Прочтите spec.md, выделите неверное или расплывчатое требование и нажмите ⌥⌘M. Напишите, что изменить. Комментарии хранит DotMD, а не файл.

3. Пусть агент исправит

   Скажите агенту: «Разбери мои комментарии в DotMD». Он прочтёт их по MCP и изменит файл. Каждое исправление видно рядом со своим комментарием, старый текст красным, новый зелёным. Примите или откройте снова каждое.

4. Только потом запускайте следующую команду

   Когда спецификация верна, запустите /speckit-plan и повторите то же для плана и задач. Ошибка, пойманная в спецификации, стоит одного комментария; пойманная в коде — переделки.

Проверка tasks.md

Список задач — это чек-лист в Markdown, а DotMD отрисовывает списки задач с флажками, так что сразу видно, что сделано и что осталось. Перед запуском /speckit-implement прочтите задачи так, как прочтёт их агент: по порядку, каждая небольшая, ни одной не пропущено. Если вы запускали шаг анализа Spec Kit, отнеситесь к его выводам так же: откройте их в DotMD и прокомментируйте те, с которыми не согласны.

Подключение агента к DotMD занимает одну строку; её показывают руководства по Claude Code, Codex и Cursor.

Зачем проверять каждый файл

Spec Kit работает быстро: одна команда, и появляется целый документ. Эта скорость и есть риск. Если в спецификации неверное требование, а вы запустили следующую команду, не прочитав её, на нём построятся и план, и задачи, и код. Внимательно прочесть spec.md один раз — самая дешёвая проверка во всём процессе.

Вопросы о Spec Kit

Другие вопросы