OpenSpecСпецифікаційно-орієнтована розробка для AI-асистентів

Наша філософія:

→ гнучке, а не жорстке
→ ітеративне, а не каскадне
→ просте, а не складне
→ створене для існуючих проєктів, а не тільки для нових
→ масштабоване від особистих проєктів до підприємств

Стежте за @0xTab на X для оновлень · Приєднуйтесь до OpenSpec Discord для допомоги та запитань.

Перегляньте в дії ​

Ви: /opsx:propose add-dark-mode
AI:  Створено openspec/changes/add-dark-mode/
     ✓ proposal.md — чому ми це робимо, що змінюється
     ✓ specs/       — вимоги та сценарії
     ✓ design.md    — технічний підхід
     ✓ tasks.md     — контрольний список реалізації
     Готово до реалізації!

Ви: /opsx:apply
AI:  Реалізація завдань...
     ✓ 1.1 Додати провайдер контексту теми
     ✓ 1.2 Створити компонент перемикача
     ✓ 2.1 Додати змінні CSS
     ✓ 2.2 Підключити localStorage
     Усі завдання виконано!

Ви: /opsx:archive
AI:  Архівовано до openspec/changes/archive/2025-01-23-add-dark-mode/
     Специфікації оновлено. Готово до наступної функції.

Швидкий старт ​

Потрібен Node.js 20.19.0 або вище.

Встановіть OpenSpec глобально:

npm install -g @fission-ai/openspec@latest

Потім перейдіть до каталогу вашого проєкту та ініціалізуйте:

cd your-project
openspec init

Тепер скажіть вашому AI: /opsx:propose <що-ви-хочете-побудувати>

Якщо ви хочете розширений робочий процес (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), виберіть його за допомогою openspec config profile та застосуйте з openspec update.

Документація ​

→ Початок роботи: перші кроки
→ Робочі процеси: комбінації та шаблони
→ Команди: слеш-команди та навички
→ CLI: довідник по терміналу
→ Підтримувані інструменти: інтеграції інструментів та шляхи встановлення
→ Концепції: як все працює разом
→ Багатомовність: підтримка кількох мов
→ Кастомізація: зробіть своїм

Чому OpenSpec? ​

AI-асистенти з кодування потужні, але непередбачувані, коли вимоги живуть лише в історії чату. OpenSpec додає легковаговий шар специфікації, щоб ви домовилися про те, що потрібно побудувати, перш ніж буде написано жодного рядка коду.

• Домовтеся перед тим, як будувати — людина та AI узгоджують специфікації до написання коду
• Залишайтеся організованими — кожна зміна отримує власну теку з пропозицією, специфікаціями, дизайном та завданнями
• Працюйте гнучко — оновлюйте будь-який артефакт у будь-який час, без жорстких фазових бар'єрів
• Використовуйте свої інструменти — працює з 20+ AI-асистентами через слеш-команди

Наше порівняння ​

vs. Spec Kit (GitHub) — Ретельний, але важковаговий. Жорсткі фазові бар'єри, багато Markdown, налаштування Python. OpenSpec легший і дозволяє вільно ітерувати.

vs. Kiro (AWS) — Потужний, але ви прив'язані до їхньої IDE та обмежені моделями Claude. OpenSpec працює з інструментами, які ви вже використовуєте.

vs. нічого — Кодування з AI без специфікацій означає нечіткі підказки та непередбачувані результати. OpenSpec забезпечує передбачуваність без зайвої бюрократії.

Оновлення OpenSpec ​

Оновіть пакет

npm install -g @fission-ai/openspec@latest

Оновіть інструкції агента

Запустіть це в кожному проєкті, щоб перегенерувати AI-керівництво та переконатися, що останні слеш-команди активні:

openspec update

Примітки щодо використання ​

Вибір моделі: OpenSpec найкраще працює з моделями з високим рівнем міркування. Ми рекомендуємо Opus 4.5 та GPT 5.2 як для планування, так і для реалізації.

Гігієна контексту: OpenSpec корисний з чистим вікном контексту. Очистіть свій контекст перед початком реалізації та підтримуйте хорошу гігієну контексту протягом усього сеансу.

Внесок ​

Невеликі виправлення — Виправлення помилок, виправлення друкарських помилок та незначні покращення можна подавати безпосередньо як PR.

Більші зміни — Для нових функцій, значних рефакторингів або архітектурних змін, будь ласка, спочатку подайте пропозицію зміни OpenSpec, щоб ми могли узгодити наміри та цілі до початку реалізації.

При написанні пропозицій пам'ятайте про філософію OpenSpec: ми обслуговуємо широкий спектр користувачів різних агентів кодування, моделей та випадків використання. Зміни повинні добре працювати для всіх.

AI-згенерований код вітається — за умови, що він був протестований та перевірений. PR, що містять AI-згенерований код, повинні згадувати використаний агент кодування та модель (наприклад, "Згенеровано за допомогою Claude Code з використанням claude-opus-4-5-20251101").

Розробка ​

• Встановіть залежності: pnpm install
• Збірка: pnpm run build
• Тестування: pnpm test
• Локальна розробка CLI: pnpm run dev або pnpm run dev:cli
• Конвенційні коміти (однорядкові): type(scope): subject

Інше ​

Ліцензія ​

MIT