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

Інші запитання