ypv 2 minggu lalu
induk
melakukan
377de01e70
2 mengubah file dengan 13 tambahan dan 11 penghapusan
  1. 5 5
      README.md
  2. 8 6
      template/specification_template.md

+ 5 - 5
README.md

@@ -23,9 +23,7 @@
 *   `app.js` — логика (физика, формулы);
 *   `app.js` — логика (физика, формулы);
 *   `style.css` — оформление;
 *   `style.css` — оформление;
 *   `manifest.json` — настройки PWA для установки на телефон.
 *   `manifest.json` — настройки PWA для установки на телефон.
-    - `docs/tz.md` — начальное техническое задание
-    - `docs/issues.md` — нумерация и описание коммитов, промты к LLM
-    - `docs/specification_template.md` — Лист спецификации
+*   `docs/specification_template.md` — Лист спецификации
 
 
 
 
 
 
@@ -36,14 +34,16 @@
 Если вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а **доказать, что он физически корректен**.
 Если вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а **доказать, что он физически корректен**.
 
 
 1. **Сделайте форк** этого репозитория (или работайте в своей ветке).
 1. **Сделайте форк** этого репозитория (или работайте в своей ветке).
-2. **Скопируйте шаблон** из папки `/template/` в папку вашей темы (например, `3.1.400/01/`). /не обязательно, можете использовать свой стиль/
+2. **Скопируйте шаблон** из папки `/template/` в папку вашей темы (например, `3.1.400/01/`). *(Не обязательно, можете использовать свой стиль).*
 3. **Заполните Лист спецификации** ([Пример](template/specification_template.md)). Для каждого проекта лист спецификаций свой. Укажите:
 3. **Заполните Лист спецификации** ([Пример](template/specification_template.md)). Для каждого проекта лист спецификаций свой. Укажите:
    * какие физические величины моделируются (и в каких единицах);
    * какие физические величины моделируются (и в каких единицах);
    * какая формула лежит в основе;
    * какая формула лежит в основе;
    * как модель должна вести себя на крайних значениях (0, бесконечность, максимум шума и т.д.).
    * как модель должна вести себя на крайних значениях (0, бесконечность, максимум шума и т.д.).
 4. **Напишите код** (можно использовать ИИ-ассистентов). [Пособие](requirements.md) по выбору темы и написанию кода.
 4. **Напишите код** (можно использовать ИИ-ассистентов). [Пособие](requirements.md) по выбору темы и написанию кода.
 5. **Проверьте модель** по вашему же листу спецификации. Если ИИ наврал в формуле — исправьте. Приложите краткий отчет о найденных ошибках ИИ.
 5. **Проверьте модель** по вашему же листу спецификации. Если ИИ наврал в формуле — исправьте. Приложите краткий отчет о найденных ошибках ИИ.
-6. **Отправьте Pull Request**. В описании PR укажите: ФИО, группу, тему и ссылку на задеплоенную версию.
+    *   **5.1.** Каждое логическое изменение (добавил сцену, исправил формулу, поправил дизайн) должно сопровождаться коммитом с осмысленным сообщением. Коммиты вида "fix" или "update" без пояснений не принимаются.
+6. **Итерация и доработка (Возврат к п. 4).** Если модель не проходит проверку или в ней обнаружены ошибки, возвращайтесь к шагу 4 (корректировка промпта или ручное исправление кода). Повторяйте цикл «генерация → проверка» до тех пор, пока модель полностью не будет соответствовать вашему Листу спецификации. Не забудьте зафиксировать каждую итерацию коммитом!
+7. **Отправьте Pull Request**. В описании PR укажите: ФИО, группу, тему и ссылку на задеплоенную версию.
 
 
 *Работы без заполненной спецификации и проверки на крайние случаи не принимаются.*
 *Работы без заполненной спецификации и проверки на крайние случаи не принимаются.*
 
 

+ 8 - 6
template/specification_template.md

@@ -47,13 +47,15 @@
 ---
 ---
 
 
 ## 4. Журнал верификации и отладки (Борьба с галлюцинациями ИИ)
 ## 4. Журнал верификации и отладки (Борьба с галлюцинациями ИИ)
-*Заполняется ПОСЛЕ генерации кода. Это доказательство того, что студент проверял работу ИИ.*
+*Заполняется ПОСЛЕ генерации кода. Это доказательство того, что студент проверял работу ИИ. Каждое исправление должно быть зафиксировано в системе контроля версий.*
 
 
-| № | Что попросили у ИИ | Что сгенерировал ИИ | Ошибка (галлюцинация) | Как исправили |
-|:--|:---|:---|:---|:---|
-| 1 | Сгенерируй шкалу затухания звука от расстояния | Сделал линейную шкалу: чем дальше, тем тише | Звук затухает не линейно, а логарифмически (закон обратных квадратов). | Заставили ИИ переписать формулу расчета дБ через логарифм. |
-| 2 | Добавь ползунок шума | При значении шума 100 дБ разборчивость стала -20% | Разборчивость не может быть отрицательной. | Добавили условие `Math.max(0, razborchivost)` в код. |
-| 3 | ... | ... | ... | ... |
+| № | Что попросили у ИИ | Что сгенерировал ИИ | Ошибка (галлюцинация) | Как исправили | Имя коммита (Git hash / сообщение) |
+|:--|:---|:---|:---|:---|:---|
+| 1 | Сгенерируй шкалу затухания звука от расстояния | Сделал линейную шкалу: чем дальше, тем тише | Звук затухает не линейно, а логарифмически (закон обратных квадратов). | Заставили ИИ переписать формулу расчета дБ через логарифм. | `a1b2c3d` — *fix: correct attenuation formula to log scale* |
+| 2 | Добавь ползунок шума | При значении шума 100 дБ разборчивость стала -20% | Разборчивость не может быть отрицательной. | Добавили условие `Math.max(0, razborchivost)` в код. | `e4f5g6h` — *fix: clamp intelligibility to 0-100%* |
+| 3 | ... | ... | ... | ... | ... |
+
+*(Если вы работаете в отдельной ветке, укажите её название перед таблицей, например: **Ветка:** `feature/akustika-model-01`)*
 
 
 ---
 ---