Специфікації
Вкладка «Специфікації» містить специфікації розробки — нормалізовані, версіоновані описи розробки, з яких працюють і агент, і люди в команді. Специфікація — це спільне джерело істини для одиниці роботи: що будується, навіщо і за якими правилами. Специфікації створюються роллю «Специфікація» в Chat — див. Developer roles.
Для чого потрібна специфікація#
Специфікація перетворює нечітку вимогу на нормалізований, версіонований опис, який агент може реалізувати, а людина — переглянути. Кожна специфікація — це родина зі стабільним spec_id, що залишається незмінним у кожній версії, тож у міру еволюції специфікації її історія є однією безперервною ниткою, а посилання на неї ніколи не ламаються. Коли ви передаєте агенту специфікацію для реалізації (зокрема в Autonomous mode), він працює з цим стабільним, версіонованим визначенням, а не з разовим повідомленням у чаті.
Список специфікацій#
Ліворуч перелічені ваші родини специфікацій. Кожен запис показує:
- Заголовок специфікації.
- Значок статусу.
- v{version} — поточна версія.
- {n} versions — скільки версій існує.
Коли в проєкті ще немає специфікацій, список показує:
No specifications yet — use the Specification role in Chat to create one.
Оберіть родину ліворуч, щоб відкрити її.
Вигляд родини#
При відкритті родини показуються три підвкладки:
| Підвкладка | Що показує | Коли доступна |
|---|---|---|
| Поточна | Поточна версія, відрендерена з Markdown | Завжди |
| Версії (N) | Кожна версія з підсумками змін для кожної | Завжди |
| Порівняти | Порівняння двох версій пліч-о-пліч | Лише за 2 або більше версій (інакше вимкнено) |
Поточна#
Підвкладка «Поточна» рендерить останню версію специфікації як форматований Markdown. Адміністратори отримують елементи керування для роботи зі специфікацією:
| Елемент керування | Що робить |
|---|---|
| Edit | Відкрити поточну версію для редагування. |
| Save | Зберегти ваші зміни. |
| Cancel | Скасувати зміни та вийти з режиму редагування. |
| Rename family | Змінити заголовок специфікації. spec_id залишається незмінним. |
| Delete | Видалити всю родину та всі її версії. |
Delete видаляє всю родину специфікації — кожну версію, а не лише поточну. Видалення окремої версії немає; це все або нічого.
Версії (N)#
Підвкладка «Версії» показує повну історію:
- Панель версій, що перелічує кожну версію за тегом. Версія, яка має підсумок змін, позначена крапкою.
- Блок «Changes in v{v}», що описує, що змінилося в обраній версії.
- Вміст обраної версії.
Використовуйте це, щоб прочитати будь-яку минулу версію точно такою, якою вона була, і побачити наратив того, як специфікація еволюціонувала.
Порівняти#
Підвкладка «Порівняти» показує різницю між будь-якими двома версіями. Для доступності потрібно щонайменше дві версії.
| Елемент керування | Що робить |
|---|---|
| Від | Обрати базову версію, з якої порівнювати. |
| До | Обрати версію, з якою порівнювати. |
| Вигляд різниці | Показує додавання та вилучення з полем + / −. |
| Блок «What changed» | Підсумок відмінностей між двома обраними версіями. |
Як створюються специфікації#
Ви не пишете специфікації тут вручну з нуля — ви генеруєте їх роллю «Специфікація» в Chat. Опишіть вимогу агенту в цій ролі, і він створить нормалізовану специфікацію, яка потім з'явиться як родина на цій вкладці. Адміністратори можуть уточнити її згодом за допомогою Edit / Save, і кожна суттєва зміна стає новою версією з власним підсумком змін.
Куди далі#
- Developer roles — зокрема роль «Специфікація», яка створює специфікації.
- Chat — де ви обираєте роль і створюєте специфікацію.
- Autonomous mode — передайте агенту специфікацію й дайте йому працювати без нагляду.
- Methodology — правила та знання, які агент застосовує під час реалізації специфікації.