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

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

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

Подивіться на роботу в дії ​

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

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

Ви: /opsx:archive
ШІ:  Архівовано до 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

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

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

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

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

Чому OpenSpec? ​

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

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

Як ми порівнюємося ​

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

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

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

Оновлення OpenSpec ​

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

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

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

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

openspec update

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

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

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

Участь у розробці ​

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

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

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

Код, згенерований ШІ, вітається — за умови, що він був протестований та перевірений. PR, що містять код, згенерований ШІ, повинні згадувати агента кодування та використану модель (наприклад, "Згенеровано за допомогою 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