Обновил git процесс

This commit is contained in:
2026-10-18 20:17:26 +03:00
parent e2e2d0bcc2
commit b5558ec008
10 changed files with 185 additions and 34 deletions
+11 -5
View File
@@ -5,7 +5,7 @@
| Артефакт | Назначение | Где находится | | Артефакт | Назначение | Где находится |
|---|---|---| |---|---|---|
| Схема OpenSpec `use-case-driven` | Русскоязычные спецификации поведения и workflow `proposal → specs / design → tasks → apply` | [`openspec/schemas/use-case-driven/`](openspec/schemas/use-case-driven/) | | Схема OpenSpec `use-case-driven` | Русскоязычные спецификации поведения и workflow `proposal → specs / design → tasks → apply` | [`openspec/schemas/use-case-driven/`](openspec/schemas/use-case-driven/) |
| Заготовки `AGENTS.md` и `config.yaml` с контекстом проекта | Правила агента, параметры проекта и начальная навигация по постоянным документам | [`examples/project-bootstrap/`](examples/project-bootstrap/) | | Заготовки `AGENTS.md` и `config.yaml` с контекстом проекта | Правила OpenSpec и Git для агента, параметры проекта и навигация по постоянным документам | [`examples/project-bootstrap/`](examples/project-bootstrap/) |
| Скилл Codex `task-tracker` | Одна задача на change: привязка, метка приложения, синхронизация, учёт времени, archive и коммит | [`skills/task-tracker/SKILL.md`](skills/task-tracker/SKILL.md) | | Скилл Codex `task-tracker` | Одна задача на change: привязка, метка приложения, синхронизация, учёт времени, archive и коммит | [`skills/task-tracker/SKILL.md`](skills/task-tracker/SKILL.md) |
Схема и скилл хранятся и развиваются здесь. Подключайте их символическими Схема и скилл хранятся и развиваются здесь. Подключайте их символическими
@@ -33,13 +33,17 @@ Master specs описывают `Purpose`, границы capability и треб
[`examples/project-bootstrap/`](examples/project-bootstrap/): [`examples/project-bootstrap/`](examples/project-bootstrap/):
- [`AGENTS.md`](examples/project-bootstrap/AGENTS.md) — навигация по контексту, - [`AGENTS.md`](examples/project-bootstrap/AGENTS.md) — навигация по контексту,
правила OpenSpec и вызовы `task-tracker` в жизненном цикле change; правила OpenSpec, Git-процесс и вызовы `task-tracker` в жизненном цикле change;
- [`openspec/config.yaml`](examples/project-bootstrap/openspec/config.yaml) — - [`openspec/config.yaml`](examples/project-bootstrap/openspec/config.yaml) —
выбор схемы и начальный контекст OpenSpec; выбор схемы и начальный контекст OpenSpec;
- `openspec/context/` — индекс контекста, правила ADR и шаблон решения. - `openspec/context/` — индекс контекста, правила ADR и шаблон решения.
Объедините заготовки с существующими файлами, сохраняя применимые инструкции Объедините заготовки с существующими файлами, сохраняя применимые инструкции
и настройки проекта. Заполните в проектном `AGENTS.md`: и настройки проекта. В шаблоне `AGENTS.md` задан двухэтапный Git-процесс:
первый PR содержит только планирование OpenSpec, второй — реализацию после
слияния первого PR и явной команды владельца. Для существующего проекта
объедините эти правила с его настройками целевой ветки и ревью. Заполните
в проектном `AGENTS.md`:
```markdown ```markdown
## Task Management ## Task Management
@@ -59,7 +63,8 @@ Lifecycle:
- При существенном изменении change синхронизируй существующую задачу. - При существенном изменении change синхронизируй существующую задачу.
- После каждого рабочего сеанса Apply синхронизируй фактическое время. - После каждого рабочего сеанса Apply синхронизируй фактическое время.
- Перед archive выполни финальную синхронизацию; после успешной архивации - Перед archive выполни финальную синхронизацию; после успешной архивации
закрой задачу и закоммить изменения change с русским описанием в 4–7 слов. закрой задачу и закоммить изменения change. Начинай сообщение коммита с ключа
связанной задачи, затем кратко опиши изменения по-русски: `CON-27 Правка тестов`.
При ошибке archive задачу не закрывай. При ошибке archive задачу не закрывай.
- При повторном запросе возобнови незавершённую синхронизацию по существующей - При повторном запросе возобнови незавершённую синхронизацию по существующей
связи, включая архивные changes. связи, включая архивные changes.
@@ -112,7 +117,8 @@ openspec/changes/archive/<archive-name>/task-tracker.yaml
Archive переносит весь каталог, включая файл связи. После успешного переноса Archive переносит весь каталог, включая файл связи. После успешного переноса
закройте YouTrack-задачу и зафиксируйте относящиеся к change изменения закройте YouTrack-задачу и зафиксируйте относящиеся к change изменения
Git-коммитом с русским сообщением из 4–7 слов. Исходный `change_id`, Git-коммитом с сообщением в формате «ключ связанной задачи + краткое описание
изменений по-русски», например `CON-27 Правка тестов`. Исходный `change_id`,
непрозрачный `task_id`, URL и снимок проектных параметров остаются в файле. непрозрачный `task_id`, URL и снимок проектных параметров остаются в файле.
Не пытайтесь восстанавливать ID только из архивного имени: change сам может Не пытайтесь восстанавливать ID только из архивного имени: change сам может
начинаться с даты. Сохраняйте файл в Git вместе с change и архивом. начинаться с даты. Сохраняйте файл в Git вместе с change и архивом.
+30 -2
View File
@@ -21,6 +21,33 @@
- Не принимай Proposed ADR самостоятельно. При конфликте запроса с принятым ADR - Не принимай Proposed ADR самостоятельно. При конфликте запроса с принятым ADR
явно сообщи о нём и запроси решение владельца. явно сообщи о нём и запроси решение владельца.
## Git-процесс OpenSpec Change
- Для каждой задачи используй одну feature-ветку от целевой ветки репозитория:
`feature/<task-code>-<task-name>`. Код бери из связанной задачи, имя —
короткий ASCII slug в нижнем регистре с дефисами. Не переименовывай уже
используемую ветку вслед за переименованием задачи.
- Используй эту ветку для двух последовательных PR в одну целевую ветку.
Обычный push разрешён только в feature-ветку; прямой push в целевую ветку,
force push и изменение чужих веток запрещены.
- Первый PR содержит только артефакты планирования OpenSpec: proposal, delta
specs либо отметку `skip_specs: true`, design, tasks и связанные метаданные.
Не начинай и не публикуй реализацию до ручного слияния первого PR и
отдельной команды владельца.
- После открытия первого PR остановись. Владелец отдельно ревьюит и вручную
сливает его, сохраняя feature-ветку. Одобрение или слияние сами по себе
не разрешают продолжать: дождись явной команды владельца в этом чате.
- После команды проверь в Git, что первый PR действительно слит в целевую
ветку. Если он ещё не слит, сообщи об этом и жди. После подтверждения
обнови ту же feature-ветку из целевой и продолжай реализацию в ней.
- Второй PR содержит реализацию, применимые проверки, документацию и
обновлённые задачи OpenSpec; добавь ссылку на задачу и первый PR. Для него
требуется отдельное актуальное ревью и успешные обязательные проверки.
Оба PR вручную сливает владелец.
- После запроса правок продолжай только по явной команде владельца. Закрытый
без слияния PR останавливает процесс до отдельного решения владельца.
Автоматическое слияние и продолжение по событиям Git не используются.
## Task Management ## Task Management
Для всех OpenSpec Changes используй скилл `task-tracker`. Для всех OpenSpec Changes используй скилл `task-tracker`.
@@ -39,8 +66,9 @@ Lifecycle:
- При существенном изменении change синхронизируй существующую задачу. - При существенном изменении change синхронизируй существующую задачу.
- После каждого рабочего сеанса Apply синхронизируй фактическое время. - После каждого рабочего сеанса Apply синхронизируй фактическое время.
- Перед archive выполни финальную синхронизацию; после успешной архивации - Перед archive выполни финальную синхронизацию; после успешной архивации
закрой связанную задачу и создай коммит с изменениями change и русским закрой связанную задачу и создай коммит с изменениями change. Начинай сообщение
описанием в 4–7 слов. При ошибке archive задачу не закрывай и коммит не создавай. коммита с ключа связанной задачи, затем кратко опиши изменения по-русски:
`CON-27 Правка тестов`. При ошибке archive задачу не закрывай и коммит не создавай.
- При повторном запросе или незавершённой синхронизации возобнови работу - При повторном запросе или незавершённой синхронизации возобнови работу
с существующей связью, включая архивные changes. с существующей связью, включая архивные changes.
+10 -2
View File
@@ -8,7 +8,8 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
В комплект входят: В комплект входят:
- `AGENTS.md` — навигация по контексту, правила OpenSpec и вызовы `task-tracker`; - `AGENTS.md` — навигация по контексту, правила OpenSpec и Git-процесс
с двумя PR, вызовы `task-tracker`;
- `openspec/config.yaml` — выбор схемы и начальный контекст OpenSpec; - `openspec/config.yaml` — выбор схемы и начальный контекст OpenSpec;
- `openspec/context/index.md` — карта постоянных документов проекта; - `openspec/context/index.md` — карта постоянных документов проекта;
- `openspec/context/adr/README.md` — правила ведения ADR; - `openspec/context/adr/README.md` — правила ведения ADR;
@@ -19,6 +20,12 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
требования из `openspec/specs/`. Перед архитектурными изменениями читайте требования из `openspec/specs/`. Перед архитектурными изменениями читайте
применимые принятые ADR. применимые принятые ADR.
Git-процесс из `AGENTS.md` использует одну feature-ветку для двух PR:
сначала PR с планированием OpenSpec, затем после ручного слияния и явной
команды владельца — PR с реализацией. При переносе шаблона в существующий
проект объедините этот раздел с проектными правилами ветвления и защиты
целевой ветки.
`ADR-template.md` соответствует `ADR-template.md` соответствует
`openspec/schemas/use-case-driven/templates/adr.md` в этом репозитории. При `openspec/schemas/use-case-driven/templates/adr.md` в этом репозитории. При
изменении исходного шаблона обновляйте его копию здесь. изменении исходного шаблона обновляйте его копию здесь.
@@ -43,7 +50,8 @@ Task tracker configuration:
[инструкции корневого README](../../README.md#подключение-из-домашней-директории). [инструкции корневого README](../../README.md#подключение-из-домашней-директории).
Создание или привязка, содержательные обновления, учёт времени, закрытие задачи Создание или привязка, содержательные обновления, учёт времени, закрытие задачи
и коммит после успешного archive выполняются по Lifecycle из `AGENTS.md`. и коммит после успешного archive выполняются по Lifecycle из `AGENTS.md`.
Сообщение коммита должно быть на русском языке и состоять из 4–7 слов. Эти правила не нужно Сообщение коммита начинайте с ключа связанной задачи, затем кратко описывайте
изменения по-русски: `CON-27 Правка тестов`. Эти правила не нужно
добавлять в схему или `config.yaml`. Запуск OpenSpec CLI вне Codex не вызывает добавлять в схему или `config.yaml`. Запуск OpenSpec CLI вне Codex не вызывает
скилл; для завершения внешней синхронизации обратитесь к агенту. скилл; для завершения внешней синхронизации обратитесь к агенту.
+16 -5
View File
@@ -5,12 +5,20 @@
формат требований определён в `schema.yaml` и шаблонах. Существующие changes формат требований определён в `schema.yaml` и шаблонах. Существующие changes
с явно указанной `schema: spec-driven` продолжают использовать свою схему. с явно указанной `schema: spec-driven` продолжают использовать свою схему.
## Git-процесс проекта
Схема задаёт порядок и формат OpenSpec-артефактов. Правила веток, двух
последовательных PR, ручного слияния и явной команды продолжения находятся
в [шаблоне проектных инструкций](../../../examples/project-bootstrap/AGENTS.md).
При подключении схемы включите правила из этого шаблона в проектный
`AGENTS.md` и согласуйте имя целевой ветки с настройками репозитория.
## Уровни спецификации ## Уровни спецификации
- Capability — отдельная бизнес-функция или понятный результат в иерархии доменов. - Capability — отдельная бизнес-функция или понятный результат в иерархии доменов.
- Границы master-спецификации фиксируют ответственность capability: что входит в её область, что исключено и кому принадлежат соседние обязанности. - Границы master-спецификации фиксируют ответственность capability: что входит в её область, что исключено и кому принадлежат соседние обязанности.
- Requirement — одна завершённая техническая функция, стабильный ID и ровно один Scenario. - Requirement — одна завершённая техническая функция, стабильный ID и ровно один Scenario.
- Scenario — один из двух форматов Use case: полный или сокращенный. Автор выбирает формат независимо от того, описываются ли БД, API, логика, UI или другая часть системы. - Scenario — один из двух форматов Use case: полный или сокращённый. Формат определяется сложностью сценария, независимо от того, описываются ли БД, API, логика, UI или другая часть системы.
- FR — подробные правила и контракты сообщений за пределами Scenario; - FR — подробные правила и контракты сообщений за пределами Scenario;
контракт HTTP endpoint размещается в завершающем CONTRACT. контракт HTTP endpoint размещается в завершающем CONTRACT.
@@ -68,8 +76,11 @@ Markdown-рендерер автоматически создаёт якоря
## Форматы Use case ## Форматы Use case
Полный Use case содержит Участников, Предусловия, Основной поток, Альтернативы и ошибки, Результат и Коды завершения. Сокращенный Use case содержит только Основной поток; каждый шаг ссылается на FR. Автор выбирает формат для конкретного описания независимо от типа FR и предмета описания. - Полный Use case используй для крупных многошаговых сценариев с большим количеством последовательных действий.
Для каждого HTTP endpoint используй отдельный Requirement и полный Use case. - Сокращённый Use case используй для простых коротких требований. Рассматривай их как кандидаты на выделение в отдельные Requirements для переиспользования в сценариях других Requirements.
- Выбирай формат по сложности: не используй полный Use case для простых требований, а сокращённый — для объёмных многошаговых сценариев. Правило действует и для HTTP endpoint.
Полный Use case содержит Участников, Предусловия, Основной поток, Альтернативы и ошибки, Результат и Коды завершения. Сокращённый Use case содержит только Основной поток; каждый шаг ссылается на FR.
```text ```text
#### Scenario: Сокращенный use case: описание функции #### Scenario: Сокращенный use case: описание функции
@@ -106,8 +117,8 @@ FR задаёт тексты, дальнейшие действия и связ
## HTTP-контракт в Requirement ## HTTP-контракт в Requirement
Каждый endpoint оформляется отдельным Requirement. Сценарий использует полный Каждый endpoint оформляется отдельным Requirement. Формат Use case выбирается
Use case; сложные правила шагов выносятся в FR. После всех FR, в конце по сложности сценария; сложные правила шагов выносятся в FR. После всех FR, в конце
Requirement, размещается раздел CONTRACT с подразделами Request и Response. Requirement, размещается раздел CONTRACT с подразделами Request и Response.
В Request указываются один HTTP-метод и путь, тело и query-параметры. В В Request указываются один HTTP-метод и путь, тело и query-параметры. В
Response указываются HTTP status и таблица сериализуемого ответа. Не создавай Response указываются HTTP status и таблица сериализуемого ответа. Не создавай
@@ -7,8 +7,8 @@ CONTRACT. Для асинхронного сообщения или технич
## HTTP endpoint ## HTTP endpoint
Каждый endpoint описывается отдельным Requirement с полным Use case. Сложные Каждый endpoint описывается отдельным Requirement; формат Use case выбирается
правила обработки указываются в FR, а контракт помещается в самом конце по сложности сценария. Сложные правила обработки указываются в FR, а контракт помещается в самом конце
Requirement: Requirement:
```markdown ```markdown
+9 -3
View File
@@ -94,8 +94,13 @@ artifacts:
пояснения, не влияющие на поведение и не снимающие неоднозначность контракта. пояснения, не влияющие на поведение и не снимающие неоднозначность контракта.
Scenario: Scenario:
- Автор выбирает полный или сокращённый сценарий независимо от типа FR - Выбирай формат по сложности сценария, независимо от типа FR и части системы
и части системы (процесс, БД, API, UI и другие), кроме обязательного полного HTTP-сценария. (процесс, БД, API, UI и другие).
- Полный Use case используй для крупных многошаговых сценариев с большим
количеством последовательных действий, а не для простых коротких требований.
- Сокращённый Use case используй для простых коротких требований, а не для
объёмных многошаговых сценариев. Рассматривай такие требования как кандидаты
на выделение в отдельные Requirements для переиспользования в сценариях других Requirements.
- Полный сценарий содержит разделы Участники, Предусловия, - Полный сценарий содержит разделы Участники, Предусловия,
Основной поток, Альтернативы и ошибки, Результат, Коды завершения — Основной поток, Альтернативы и ошибки, Результат, Коды завершения —
в таком порядке. в таком порядке.
@@ -105,7 +110,8 @@ artifacts:
которых нет в заголовке. Контекст отсутствует. которых нет в заголовке. Контекст отсутствует.
- Основной поток — нумерованные короткие шаги «Что делаем — как делаем». - Основной поток — нумерованные короткие шаги «Что делаем — как делаем».
- В шаге выполнения можно указать действие, endpoint API или способ записи со ссылкой на FR. - В шаге выполнения можно указать действие, endpoint API или способ записи со ссылкой на FR.
- Каждую конечную точку HTTP описывай отдельным Requirement с полным сценарием. - Каждую конечную точку HTTP описывай отдельным Requirement; формат сценария
выбирай по его сложности.
Сложные правила шагов выноси в FR со ссылками из сценария. Сложные правила шагов выноси в FR со ссылками из сценария.
- Основной поток и альтернативы обычного сценария включают коды - Основной поток и альтернативы обычного сценария включают коды
завершения, если они определены для этой функции. завершения, если они определены для этой функции.
@@ -20,6 +20,12 @@
Система SHALL <наблюдаемый результат завершённой функции>. Система SHALL <наблюдаемый результат завершённой функции>.
<!-- Выбирай формат по сложности сценария, независимо от типа FR и части системы.
Полный Use case используй для крупных многошаговых сценариев; сокращённый —
для простых коротких требований. Такие требования — кандидаты на выделение
в отдельные Requirements для переиспользования в сценариях других Requirements.
Не используй полный формат для простых требований, а сокращённый — для объёмных. -->
#### Scenario: <название завершённого процесса> #### Scenario: <название завершённого процесса>
##### Участники ##### Участники
@@ -69,7 +75,7 @@ HTTP endpoint располагай в завершающем разделе CONT
<При необходимости — параметры сообщений, связанные требования и соответствие <При необходимости — параметры сообщений, связанные требования и соответствие
действующему runtime. Явно отметь коды и тексты, которые ещё не реализованы.> действующему runtime. Явно отметь коды и тексты, которые ещё не реализованы.>
<!-- HTTP endpoint описывай в отдельном Requirement с полным Use case. <!-- HTTP endpoint описывай в отдельном Requirement; формат Use case выбирай по сложности.
Контракт размещай в конце Requirement, не разбивая request/response на FR: Контракт размещай в конце Requirement, не разбивая request/response на FR:
#### CONTRACT #### CONTRACT
@@ -87,9 +93,7 @@ HTTP status: <код и условие возврата>.
| `field_name` | `JSON type` | <Обязательное или опциональное> | <Ограничения> | <Назначение> | <Источник или правило формирования> | | `field_name` | `JSON type` | <Обязательное или опциональное> | <Ограничения> | <Назначение> | <Источник или правило формирования> |
--> -->
<!-- Автор выбирает полный или сокращенный Use case по ситуации, независимо от <!-- Для сокращённого Use case замени полный Scenario следующим блоком:
типа FR и предмета описания. Для сокращенного Use case используй только основной
поток и ссылки на FR:
#### Scenario: Сокращенный use case: <предмет описания> #### Scenario: Сокращенный use case: <предмет описания>
@@ -417,8 +417,6 @@ def check_requirement(
scenario, details = block.split("#### Функциональные требования", 1) scenario, details = block.split("#### Функциональные требования", 1)
scenario = scenario.split("#### Scenario:", 1)[1].split("\n", 1)[1] scenario = scenario.split("#### Scenario:", 1)[1].split("\n", 1)[1]
if has_contract: if has_contract:
if is_short_use_case:
errors.append("Requirement с HTTP CONTRACT должен использовать полный Use case")
details, contract_content = details.split("#### CONTRACT", 1) details, contract_content = details.split("#### CONTRACT", 1)
errors.extend(check_http_endpoint_contract(contract_content)) errors.extend(check_http_endpoint_contract(contract_content))
sections = re.findall(r"^##### (.+)$", scenario, re.MULTILINE) sections = re.findall(r"^##### (.+)$", scenario, re.MULTILINE)
+18 -9
View File
@@ -9,6 +9,8 @@ description: Веди задачу YouTrack при работе с OpenSpec Chan
Используй YouTrack MCP по текущим контрактам инструментов. Используй YouTrack MCP по текущим контрактам инструментов.
Если пользователь передал ID задачи для начала Explore/Propose или работы над Если пользователь передал ID задачи для начала Explore/Propose или работы над
change, начинай с контекста этой задачи и используй её; новую задачу не создавай. change, начинай с контекста этой задачи и используй её; новую задачу не создавай.
Переданная задача может иметь любой тип: сохраняй её `Type` и не отклоняй
задачу из-за его значения.
## Настройки и связь ## Настройки и связь
@@ -17,6 +19,8 @@ change, начинай с контекста этой задачи и испол
custom field `Labels`, если оно есть; иначе используй точный тег YouTrack. custom field `Labels`, если оно есть; иначе используй точный тег YouTrack.
Не записывай значение одновременно в поле и тег. Отсутствующие значения, Не записывай значение одновременно в поле и тег. Отсутствующие значения,
placeholders или конфликт настроек требуют уточнения. placeholders или конфликт настроек требуют уточнения.
Если в переданной задаче нужной метки нет, добавляй её автоматически без запроса
подтверждения; после записи проверь результат через `get_issue`.
Храни `task-tracker.yaml` в каталоге change реального OpenSpec store, Храни `task-tracker.yaml` в каталоге change реального OpenSpec store,
включай в Git: archive переносит файл вместе с change. включай в Git: archive переносит файл вместе с change.
@@ -43,10 +47,10 @@ worklog:
1. **Найди:** приоритет у явно переданного пользователем ID, затем у связи 1. **Найди:** приоритет у явно переданного пользователем ID, затем у связи
в активном каталоге/архиве по точному `change_id`, старых ссылок proposal в активном каталоге/архиве по точному `change_id`, старых ссылок proposal
и результатов поиска. Для переданного ID сразу вызови `get_issue`; проверь и результатов поиска. Для переданного ID сразу вызови `get_issue`; проверь
существование задачи, проект, тип и отсутствие `subtask of`. Используй её существование задачи, проект и отсутствие `subtask of`. Используй её
как авторитетную связь для этого запроса, даже если локальная связь отсутствует как авторитетную связь для этого запроса, даже если локальная связь отсутствует
или содержит прежний ID; прежнюю задачу не обновляй. Если ID не существует или содержит прежний ID; прежнюю задачу не обновляй. Если ID не существует
или не подходит по проекту/типу, остановись и сообщи об этом — замену не создавай. или не подходит по проекту, остановись и сообщи об этом — замену не создавай.
Для остальных найденных задач через `get_issue` проверь принадлежность change, Для остальных найденных задач через `get_issue` проверь принадлежность change,
проект и отсутствие `subtask of`. проект и отсутствие `subtask of`.
Без ID ищи `search_issues` по проекту и маркеру Без ID ищи `search_issues` по проекту и маркеру
@@ -60,17 +64,20 @@ worklog:
specs/design/tasks (включая `skip_specs`), привяжи найденную задачу или создай specs/design/tasks (включая `skip_specs`), привяжи найденную задачу или создай
новую только для активного change после полного поиска без результатов и новую только для активного change после полного поиска без результатов и
незавершённых попыток. незавершённых попыток.
Через `get_project` и `get_issue_fields_schema` проверь проект, Через `get_project` и `get_issue_fields_schema` проверь проект и обязательные
`Type: Task` и обязательные поля. Сверь схему проекта с правилом выбора поля. `Type: Task` задавай только при создании новой задачи; у существующей
способа хранения в разделе «Настройки и связь». задачи сохраняй её тип. Сверь схему проекта с правилом выбора способа хранения
в разделе «Настройки и связь».
`create_issue`: русский заголовок по proposal и блок описания из шага 3, `create_issue`: русский заголовок по proposal и блок описания из шага 3,
без родителя. Если найдено строковое поле `Labels`, передай в `customFields` без родителя. Если найдено строковое поле `Labels`, передай в `customFields`
точное значение `Application label`; если поля нет, добавь точный тег через точное значение `Application label`; если поля нет, добавь точный тег через
`manage_issue_tags`. Сразу сохрани ID/URL и проверь через `get_issue`, что `manage_issue_tags`. Сразу сохрани ID/URL и проверь через `get_issue`, что
метка записана выбранным способом. метка записана выбранным способом.
Для существующей задачи сначала прочитай поле/теги через `get_issue`. Для существующей задачи сначала прочитай поле/теги через `get_issue`.
Если метка уже есть — не меняй её. Если поле `Labels` непустое и содержит Если точная метка уже есть — не меняй её. Если её нет, добавь без вопроса:
другое значение, не перезаписывай его и уточни, как сохранить оба значения. пустое поле `Labels` заполни значением `Application label`; в непустое строковое
поле допиши `, <Application label>`, сохранив прежний текст и не дублируя значение.
Для хранения тегом вызови `manage_issue_tags` с точным `Application label`.
При работе через тег не подменяй имя похожим. Если `manage_issue_tags` вернул При работе через тег не подменяй имя похожим. Если `manage_issue_tags` вернул
ошибку, сохрани полный ответ, включая подсказки, и перечитай задачу на случай ошибку, сохрани полный ответ, включая подсказки, и перечитай задачу на случай
частично успешной операции. Сообщение «tag not found or not accessible» не частично успешной операции. Сообщение «tag not found or not accessible» не
@@ -95,8 +102,10 @@ worklog:
коммитом проверь `git status` и diff; не включай несвязанные или чужие коммитом проверь `git status` и diff; не включай несвязанные или чужие
staged/working-tree изменения. Если изменения нельзя безопасно отделить, staged/working-tree изменения. Если изменения нельзя безопасно отделить,
оставь файлы незакоммиченными, сообщи о блокере и не создавай частичный коммит. оставь файлы незакоммиченными, сообщи о блокере и не создавай частичный коммит.
Сообщение коммита должно быть на русском, описывать фактические изменения и Сообщение коммита начинай с читаемого ключа связанной задачи YouTrack и пробела,
содержать 4–7 слов, считая слова по пробелам. Для архивного change продолжай затем кратко опиши фактические изменения по-русски: `CON-27 Правка тестов`.
Ключ бери из данных задачи; не подставляй вместо него непрозрачный `task_id`.
Для архивного change продолжай
только незавершённые шаги и не запускай archive повторно. только незавершённые шаги и не запускай archive повторно.
## Время и восстановление ## Время и восстановление
+81
View File
@@ -0,0 +1,81 @@
import sys
import unittest
from pathlib import Path
SCHEMA_DIR = Path(__file__).resolve().parents[1] / "openspec/schemas/use-case-driven"
sys.path.insert(0, str(SCHEMA_DIR))
import validate_format # noqa: E402
SHORT_REQUIREMENT = """### Requirement: Проверка готовности
**ID:** `SYS.HLT-01`
Система SHALL возвращать признак готовности к обработке запросов.
#### Scenario: Сокращенный use case: проверка готовности
##### Основной поток
1. Возвращаем признак готовности по [SYS.HLT-01.FR-01](#syshlt-01fr-01-признак-готовности).
#### Функциональные требования
##### SYS.HLT-01.FR-01: Признак готовности
Признак готовности равен true, когда приложение готово обрабатывать запросы.
"""
HTTP_CONTRACT = """
#### CONTRACT
##### Request
Метод: `GET`; путь: `/health`. Тело запроса отсутствует.
##### Response
HTTP status: `200` при готовности приложения.
| Поле | Тип | Обязательность | Ограничения и значение по умолчанию | Назначение | Формирование значения |
| --- | --- | --- | --- | --- | --- |
| `ready` | `boolean` | Обязательное | Только true; значения по умолчанию нет | Готовность приложения | По правилу SYS.HLT-01.FR-01 |
"""
class ShortUseCaseTests(unittest.TestCase):
def check_requirement(self, block: str) -> list[str]:
targets, fr_targets = validate_format.heading_targets(block)
return validate_format.check_requirement(
"Проверка готовности", block, targets, fr_targets,
require_qualified_ids=True,
)
def test_accepts_a_simple_requirement_without_http_contract(self) -> None:
self.assertEqual(self.check_requirement(SHORT_REQUIREMENT), [])
def test_accepts_a_simple_http_requirement_with_short_use_case(self) -> None:
self.assertEqual(self.check_requirement(SHORT_REQUIREMENT + HTTP_CONTRACT), [])
def test_short_http_use_case_still_requires_a_valid_contract(self) -> None:
contract = HTTP_CONTRACT.replace("HTTP status:", "Status:")
errors = self.check_requirement(SHORT_REQUIREMENT + contract)
self.assertTrue(any("в Response укажи HTTP status" in error for error in errors))
def test_short_http_use_case_still_rejects_extra_scenario_sections(self) -> None:
requirement = SHORT_REQUIREMENT.replace(
"##### Основной поток",
"##### Участники\n\n- Оператор.\n\n##### Основной поток",
)
errors = self.check_requirement(requirement + HTTP_CONTRACT)
self.assertTrue(any("только Основной поток" in error for error in errors))
if __name__ == "__main__":
unittest.main()