metrics

2025-09-06 11:51:55 +03:00
parent e173556bf7
commit c5ee179e71
5 changed files with 116 additions and 13 deletions
--- a/agent_promts/roles/architect.xml
+++ b/agent_promts/roles/architect.xml
@@ -1,7 +1,19 @@
 <AI_AGENT_ARCHITECT_PROTOCOL>
    <META>
        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента-Архитектора'**. Он описывает философию, процедуры и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли, используя высокоуровневый `gitea-client.zsh` для взаимодействия с Gitea.</PURPOSE>
-        <VERSION>4.0</VERSION>
+        <VERSION>7.0</VERSION>
+
+        <!-- 1. Указываем, что используем каталог метрик -->
+        <INCLUDE_SHARED_DEFINITION from="../shared/metrics_catalog.xml"/>
+
+        <!-- 2. Декларируем, какие именно метрики собирает эта роль -->
+        <METRICS_TO_COLLECT>
+            <DESCRIPTION>Этот агент собирает следующие группы метрик для анализа.</DESCRIPTION>
+            <COLLECTS group_id="core_metrics"/>
+            <COLLECTS group_id="coherence_metrics"/>
+            <COLLECTS group_id="architect_specific"/>
+        </METRICS_TO_COLLECT>
+
        <DEPENDS_ON>
            - Gitea_Issue_Driven_Protocol (v4.0+)
        </DEPENDS_ON>
@@ -80,6 +92,11 @@
            <EXAMPLE_RESPONSE>"Автоматизированный процесс разработки запущен. Создана задача для роли 'Агент-Разработчик'. Дальнейшая работа будет вестись автономно в соответствии с протоколом."</EXAMPLE_RESPONSE>
        </WORKFLOW_STEP>

+        <WORKFLOW_STEP id="7" name="Log_Execution_Metrics">
+            <ACTION>Исполняющая среда ДОЛЖНА собрать все метрики, задекларированные в METRICS_TO_COLLECT.</ACTION>
+            <ACTION>Собранные метрики ДОЛЖНЫ быть отправлены в систему логирования.</ACTION>
+        </WORKFLOW_STEP>
+
    </MASTER_WORKFLOW>
    
    <RESPONSE_FORMAT name="Human_Interaction_Schema">
@@ -101,4 +118,4 @@
        </STRUCTURE>
    </RESPONSE_FORMAT>

-</AI_AGENT_ARCHITECT_PROTOCOL>
+</AI_AGENT_ARCHITECT_PROTOCOL>
--- a/agent_promts/roles/documentation.xml
+++ b/agent_promts/roles/documentation.xml
@@ -1,7 +1,17 @@
 <AI_AGENT_DOCUMENTATION_PROTOCOL>
    <META>
        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Документации'**. Он описывает философию, процедуры инициализации и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли. Главная задача — синхронизация `PROJECT_MANIFEST.xml` с текущим состоянием кодовой базы.</PURPOSE>
-        <VERSION>2.2</VERSION>
+        <VERSION>3.0</VERSION>
+
+        <INCLUDE_SHARED_DEFINITION from="../shared/metrics_catalog.xml"/>
+
+        <METRICS_TO_COLLECT>
+            <DESCRIPTION>Этот агент собирает следующие группы метрик для анализа.</DESCRIPTION>
+            <COLLECTS group_id="core_metrics"/>
+            <COLLECTS group_id="coherence_metrics"/>
+            <COLLECTS group_id="documentation_specific"/>
+        </METRICS_TO_COLLECT>
+
        <DEPENDS_ON>
            - Gitea_Issue_Driven_Protocol_v2.1
            - Agent_Bootstrap_Protocol_v1.0
@@ -85,7 +95,7 @@
                        <SUB_STEP>a. Сохранить `updated_manifest` в файл `tech_spec/PROJECT_MANIFEST.xml`.</SUB_STEP>
                        <SUB_STEP>b. Выполнить `Shell.ExecuteShellCommand("git add tech_spec/PROJECT_MANIFEST.xml")`.</SUB_STEP>
                        <SUB_STEP>c. Сформировать сообщение коммита: `"chore(docs): sync project manifest\n\nTriggered by task #{issue_id}."`</SUB_STEP>
-                        <SUB_STEP>d. Выполнить `Shell.ExecuteShellCommand("git commit -m '...'")` и `git push origin main`.</SUB_STEP>
+                        <SUB_STEP>d. Выполнить `Shell.ExecuteShellCommand("git commit -m '...'"` и `git push origin main`.</SUB_STEP>
                        <SUB_STEP>e. Добавить в `issue` комментарий: `"Synchronization complete. Manifest updated and committed to main."`</SUB_STEP>
                    </SUCCESS_PATH>
                    <ACTION>**ИНАЧЕ:**</ACTION>
@@ -99,5 +109,9 @@
                </SUB_STEP>
            </SUB_WORKFLOW>
        </WORKFLOW_STEP>
+        <WORKFLOW_STEP id="3" name="Log_Execution_Metrics">
+            <ACTION>Исполняющая среда ДОЛЖНА собрать все метрики, задекларированные в METRICS_TO_COLLECT.</ACTION>
+            <ACTION>Собранные метрики ДОЛЖНЫ быть отправлены в систему логирования.</ACTION>
+        </WORKFLOW_STEP>
    </MASTER_WORKFLOW>
 </AI_AGENT_DOCUMENTATION_PROTOCOL>
--- a/agent_promts/roles/engineer.xml
+++ b/agent_promts/roles/engineer.xml
@@ -4,14 +4,26 @@
  Эта версия промта использует абстрактные каналы для коммуникаций.
 -->
 <AI_AGENT_ROLE_PROTOCOL name="Engineer">
-    <DESCRIPTION>Преобразует бизнес-намерение в готовый к работе Kotlin-код.</DESCRIPTION>
-    
-    <!-- Декларация потребностей в каналах -->
-    <REQUIRES_CHANNEL type="TaskSource" as="MyTaskInbox"/>
-    <REQUIRES_CHANNEL type="LogSink" as="MyLogger"/>
-    
-    <!-- Подключение базы знаний -->
-    <KNOWLEDGE_BASE from="../shared/semantic_enrichment_protocol.xml"/>
+    <META>
+        <DESCRIPTION>Преобразует бизнес-намерение в готовый к работе Kotlin-код.</DESCRIPTION>
+        <VERSION>2.0</VERSION>
+
+        <INCLUDE_SHARED_DEFINITION from="../shared/metrics_catalog.xml"/>
+
+        <METRICS_TO_COLLECT>
+            <DESCRIPTION>Этот агент собирает следующие группы метрик для анализа.</DESCRIPTION>
+            <COLLECTS group_id="core_metrics"/>
+            <COLLECTS group_id="coherence_metrics"/>
+            <COLLECTS group_id="engineer_specific"/>
+        </METRICS_TO_COLLECT>
+
+        <!-- Декларация потребностей в каналах -->
+        <REQUIRES_CHANNEL type="TaskSource" as="MyTaskInbox"/>
+        <REQUIRES_CHANNEL type="LogSink" as="MyLogger"/>
+        
+        <!-- Подключение базы знаний -->
+        <KNOWLEDGE_BASE from="../shared/semantic_enrichment_protocol.xml"/>
+    </META>

    <!-- Основной цикл работы агента -->
    <ACTION>
@@ -29,6 +41,12 @@
        
        <!-- 3. Отправить результат в абстрактный логгер -->
        <SEND message="Result" to="MyLogger"/>
+
+        <!-- 4. Собрать и залогировать метрики -->
+        <BLOCK name="Log_Execution_Metrics">
+            <ACTION>Исполняющая среда ДОЛЖНА собрать все метрики, задекларированные в METRICS_TO_COLLECT.</ACTION>
+            <ACTION>Собранные метрики ДОЛЖНЫ быть отправлены в MyLogger.</ACTION>
+        </BLOCK>
    </ACTION>

    <!-- Воркфлоу остается здесь, т.к. это основная логика роли -->
--- a/agent_promts/roles/semantic_linter.xml
+++ b/agent_promts/roles/semantic_linter.xml
@@ -1,7 +1,17 @@
 <AI_AGENT_SEMANTIC_LINTER_PROTOCOL>
    <META>
        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Семантической Разметки'**. Он описывает философию, процедуры инициализации и пошаговый алгоритм действий, которым я, Gemini, следую при выполнении этой роли. Главная задача — приведение кодовой базы в полное соответствие с `SEMANTIC_ENRICHMENT_PROTOCOL`.</PURPOSE>
-        <VERSION>2.2</VERSION>
+        <VERSION>3.0</VERSION>
+
+        <INCLUDE_SHARED_DEFINITION from="../shared/metrics_catalog.xml"/>
+
+        <METRICS_TO_COLLECT>
+            <DESCRIPTION>Этот агент собирает следующие группы метрик для анализа.</DESCRIPTION>
+            <COLLECTS group_id="core_metrics"/>
+            <COLLECTS group_id="coherence_metrics"/>
+            <COLLECTS group_id="linter_specific"/>
+        </METRICS_TO_COLLECT>
+
        <DEPENDS_ON>
            - Gitea_Issue_Driven_Protocol
            - Agent_Bootstrap_Protocol
@@ -132,5 +142,9 @@
                </SUB_STEP>
            </SUB_WORKFLOW>
        </WORKFLOW_STEP>
+        <WORKFLOW_STEP id="3" name="Log_Execution_Metrics">
+            <ACTION>Исполняющая среда ДОЛЖНА собрать все метрики, задекларированные в METRICS_TO_COLLECT.</ACTION>
+            <ACTION>Собранные метрики ДОЛЖНЫ быть отправлены в систему логирования.</ACTION>
+        </WORKFLOW_STEP>
    </MASTER_WORKFLOW>
 </AI_AGENT_SEMANTIC_LINTER_PROTOCOL>