Уточнить поведение при отсутствии совпадения action

This commit is contained in:
2026-04-09 08:26:40 +03:00
parent 3ae30a5263
commit 4aa2e136b2

View File

@@ -1,74 +1,67 @@
# ACTIONS.md # ACTIONS.md
Внутренний ранбук действий для ассистента в этом репозитории. VERSION: 2
Цель: выполнять типовые задачи одинаково, быстро и в рамках `AGENTS.md`. MODE: machine-first
LANG: ru
## Операционный протокол (для любого action) ROUTING:
1. Проверить ограничения из `AGENTS.md` и подтвердить границы задачи. - match_user_request_to_action_id: true
2. Зафиксировать короткий план выполнения (3-7 шагов). - if_match: propose_action
3. Выполнить изменения минимально и точечно. - if_no_match: ignore_actions_md
4. Проверить результат по чек-листу action. - if_no_match_user_message: none
5. Показать пользователю итог и спросить разрешение на commit/push.
## Шаблон action PROPOSE_RULE:
- `Команда`: уникальный идентификатор `section:name`. - prompt_template: "Приступить к выполнению '{action_id}'?"
- `Назначение`: какой результат должен быть получен. - require_user_confirmation: true
- `Входы`: конкретные файлы/источники. - execute_without_confirmation: false
- `План`: исполняемые шаги без абстракций.
- `Проверка`: как подтверждается корректность.
- `Выход`: какие файлы меняются.
- `Отчет пользователю`: формат финального сообщения.
## Action: создать новый action EXECUTION_BASELINE:
- `Команда`: `action:new` - enforce_agents_md: true
- `Назначение`: добавить новый повторяемый сценарий в `ACTIONS.md`. - minimal_non_breaking_changes: true
- `Входы`: описание задачи от пользователя. - steps_count_range: [3, 7]
- `План`: - before_commit_push: request_user_approval
1. Уточнить цель, границы, ожидаемый результат.
2. Предложить имя команды `section:name` и согласовать.
3. Заполнить все поля шаблона action.
4. Проверить уникальность команды в файле.
5. Показать пользователю готовый блок перед commit.
- `Проверка`:
- Команда не дублируется.
- План выполним в рамках `AGENTS.md`.
- Есть явный критерий завершения.
- `Выход`: обновленный `ACTIONS.md`.
- `Отчет пользователю`:
- Что добавлено.
- Какой командой запускать.
- Что будет считаться завершением.
## Action: обновление перевода REPORT_FORMAT:
- `Команда`: `translation:update` - done
- `Назначение`: синхронизировать `russian.xml` с upstream English с сохранением терминологии. - changed_files
- `Входы`: - checks
- `Mods/DnD 5.5e AIO Russian/Localization/Russian/russian.xml` - remaining
- upstream English (ссылка в `AGENTS.md`)
- `glossary/glossary.normalized.json`
- `План`:
1. Сопоставить English и Russian по ключам.
2. Разделить расхождения на `new`, `changed`, `stale-candidate`.
3. Обновить перевод для `new` и `changed` по глоссарию.
4. Проверить XML-целостность и служебные атрибуты.
5. Подготовить краткий список выполненных изменений.
- `Проверка`:
- XML не поврежден.
- Термины согласованы с глоссарием.
- Нет изменений за пределами локализации/разрешенных метаданных.
- `Выход`:
- обновленный `russian.xml`
- при релизном шаге: согласованные изменения в `meta.lsx` по правилам версии
- `Отчет пользователю`:
- Сколько строк добавлено/обновлено/помечено как `stale-candidate`.
- Какие файлы изменены.
- Нужен ли следующий релизный шаг.
## Action: отчет по выполнению (внутренний формат) ACTIONS:
- `Команда`: `action:report` translation:update:
- `Назначение`: единый короткий формат отчета после любого action. intent: sync_ru_translation_with_upstream
- `Шаблон отчета`: inputs:
1. Что сделано. - Mods/DnD 5.5e AIO Russian/Localization/Russian/russian.xml
2. Какие файлы изменены. - glossary/glossary.normalized.json
3. Что проверено. - AGENTS.md::Canonical Paths::Upstream English reference
4. Что остается (если есть). plan:
- compare_en_vs_ru_by_keys
- classify_diff_into_new_changed_stale_candidate
- update_ru_for_new_and_changed_using_glossary
- validate_xml_structure_and_service_attributes
- prepare_delta_summary_counts
checks:
- xml_valid
- glossary_consistency
- scope_limited_to_localization_and_allowed_metadata
outputs:
- Mods/DnD 5.5e AIO Russian/Localization/Russian/russian.xml
- optional: Mods/DnD 5.5e AIO Russian/meta.lsx (release-only)
action:report:
intent: unified_task_report
inputs:
- task_context
- modified_files
- verification_results
plan:
- summarize_done
- list_changed_files
- list_checks
- list_remaining
checks:
- concise
- factual
- no_unverified_claims
outputs:
- final_user_report