busya/homebox_lens
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

rewrite promts for gitea_client

Browse Source
This commit is contained in:
busya
2025-09-05 10:52:57 +03:00
parent b87f898468
commit 7d2d15b39f
7 changed files with 143 additions and 210 deletions
Download Patch File Download Diff File Expand all files Collapse all files

102
agent_promts/GITEA_ISSUE_DRIVEN_PROTOCOL.xml
View File

@@ -1,12 +1,12 @@
<GITEA_ISSUE_DRIVEN_PROTOCOL>
<META>
<PURPOSE>Определить единый, отказоустойчивый и полностью автоматизированный протокол для межагентной коммуникации, постановки задач и управления жизненным циклом кода. Gitea служит центральной коммуникационной шиной и системой контроля версий. Взаимодействие с Gitea осуществляется через утилиту командной строки 'tea-cli'.</PURPOSE>
<VERSION>3.0</VERSION>
<PURPOSE>Определить единый, отказоустойчивый и полностью автоматизированный протокол для межагентной коммуникации, постановки задач и управления жизненным циклом кода. Gitea служит центральной коммуникационной шиной и системой контроля версий. Взаимодействие с Gitea осуществляется через утилиту командной строки 'gitea-client.zsh'.</PURPOSE>
<VERSION>3.1</VERSION>
</META>
<CORE_PRINCIPLES>
<PRINCIPLE name="Gitea_As_The_System_Bus">
<DESCRIPTION>Gitea Issues и Pull Requests являются единственным каналом для асинхронной коммуникации между AI-агентами. Взаимодействие происходит через 'tea-cli'.</DESCRIPTION>
<DESCRIPTION>Gitea Issues и Pull Requests являются единственным каналом для асинхронной коммуникации между AI-агентами. Взаимодействие происходит через 'gitea-client.zsh'.</DESCRIPTION>
</PRINCIPLE>
<PRINCIPLE name="Human_Out_Of_The_Loop">
<DESCRIPTION>Человек взаимодействует с системой исключительно через диалог с Агентом-Архитектором. Gitea используется как "закулисный" механизм, и человек не должен создавать, комментировать или назначать Issues вручную.</DESCRIPTION>
@@ -18,39 +18,34 @@
<DESCRIPTION>Каждое действие в системе должно быть отслеживаемым. Это достигается за счет неразрывной связи: `GiteaIssue ID` <-> `Имя ветки` <-> `Pull Request ID`.</DESCRIPTION>
</PRINCIPLE>
<PRINCIPLE name="Initial_Check">
<DESCRIPTION>Перед началом работы проверь логин tea-cli whoami. Логин должен соответствовать твоей роли агента</DESCRIPTION>
<DESCRIPTION>Перед началом работы агент должен убедиться, что он аутентифицирован под своей ролью, используя `gitea-client.zsh <ROLE> whoami` или аналогичную команду.</DESCRIPTION>
</PRINCIPLE>
</CORE_PRINCIPLES>
<CLI_COMMANDS name="tea-cli">
<COMMAND name="create_issue">
<SYNTAX>`tea-cli issues create --title "{title}" --body "{body}" --assignee "{assignee}" --labels "{labels}"`</SYNTAX>
<DESCRIPTION>Создает новое Issue.</DESCRIPTION>
<CLI_COMMANDS name="gitea-client.zsh">
<COMMAND name="create-task">
<SYNTAX>`./gitea-client.zsh {role} create-task --title "{title}" --body "{body}" --assignee "{assignee}" --labels "{labels}"`</SYNTAX>
<DESCRIPTION>Создает новую задачу (Issue) в Gitea.</DESCRIPTION>
</COMMAND>
<COMMAND name="list_issues">
<SYNTAX>`tea-cli issues list --assignee "{assignee}" --labels "{labels}" --state "open"`</SYNTAX>
<RATIONALE>ВНИМАНИЕ: Фильтрация по assignee и labels в tea-cli может работать некорректно. Агент должен самостоятельно фильтровать полученный список задач.</RATIONALE>
<DESCRIPTION>Ищет открытые Issues по исполнителю и меткам.</DESCRIPTION>
<COMMAND name="find-tasks">
<SYNTAX>`./gitea-client.zsh {role} find-tasks --type "{type_label}"`</SYNTAX>
<DESCRIPTION>Ищет открытые задачи с меткой `status::pending` и указанным типом.</DESCRIPTION>
</COMMAND>
<COMMAND name="update_issue">
<SYNTAX>`tea-cli issues edit {issue-id} --add-labels "{labels_to_add}" --remove-labels "{labels_to_remove}" --title "{title}" --assignee "{assignee}"`</SYNTAX>
<DESCRIPTION>Редактирует существующее Issue, в основном для смены статуса и исполнителя.</DESCRIPTION>
<COMMAND name="update-task-status">
<SYNTAX>`./gitea-client.zsh {role} update-task-status --issue-id {id} --old "{old_status}" --new "{new_status}"`</SYNTAX>
<DESCRIPTION>Изменяет статус задачи путем замены меток.</DESCRIPTION>
</COMMAND>
<COMMAND name="close_issue">
<SYNTAX>`tea-cli issues close {issue-id}`</SYNTAX>
<DESCRIPTION>Закрывает Issue.</DESCRIPTION>
</COMMAND>
<COMMAND name="create_pr">
<SYNTAX>`tea-cli pull-request create --title "{title}" --body "{body}" --head "{branch_name}" --base "main"`</SYNTAX>
<COMMAND name="create-pr">
<SYNTAX>`./gitea-client.zsh {role} create-pr --title "{title}" --body "{body}" --head "{branch_name}"`</SYNTAX>
<DESCRIPTION>Создает Pull Request.</DESCRIPTION>
</COMMAND>
<COMMAND name="merge_pr">
<SYNTAX>`tea-cli pull-request merge {pr-id}`</SYNTAX>
<DESCRIPTION>Сливает Pull Request.</DESCRIPTION>
<COMMAND name="merge-and-complete">
<SYNTAX>`./gitea-client.zsh {role} merge-and-complete --issue-id {id} --pr-id {pr_id} --branch "{branch_name}"`</SYNTAX>
<DESCRIPTION>Атомарная операция: сливает PR, удаляет ветку и закрывает связанную задачу.</DESCRIPTION>
</COMMAND>
<COMMAND name="close_pr">
<SYNTAX>`tea-cli pull-request close {pr-id}`</SYNTAX>
<DESCRIPTION>Отклоняет (закрывает) Pull Request.</DESCRIPTION>
<COMMAND name="return-to-dev">
<SYNTAX>`./gitea-client.zsh {role} return-to-dev --issue-id {id} --pr-id {pr_id} --report "{report_body}"`</SYNTAX>
<DESCRIPTION>Атомарная операция: отклоняет PR, добавляет отчет о дефектах в задачу и возвращает ее разработчику.</DESCRIPTION>
</COMMAND>
</CLI_COMMANDS>
@@ -67,6 +62,8 @@
<CATEGORY prefix="type::">
<LABEL name="type::development">Задача для Агента-Разработчика.</LABEL>
<LABEL name="type::quality-assurance">Задача для QA-Агента.</LABEL>
<LABEL name="type::documentation">Задача для Агента Документации.</LABEL>
<LABEL name="type::linting">Задача для Агента Семантической Разметки.</LABEL>
</CATEGORY>
</SCHEMA>
</SPECIFICATION>
@@ -74,7 +71,7 @@
<DESCRIPTION>Единый формат для всех веток, создаваемых AI-агентами.</DESCRIPTION>
<TEMPLATE>`{type}/{issue-id}/{kebab-case-description}`</TEMPLATE>
<COMPONENTS>
<COMPONENT name="type">'feature' для новой разработки, 'fix' для исправлений.</COMPONENT>
<COMPONENT name="type">'feature' для новой разработки, 'fix' для исправлений, 'chore' для технических задач.</COMPONENT>
<COMPONENT name="issue-id">Номер Gitea Issue, инициировавшего создание ветки.</COMPONENT>
<COMPONENT name="kebab-case-description">Машиночитаемый заголовок Issue.</COMPONENT>
</COMPONENTS>
@@ -88,42 +85,37 @@
</STEP>
<STEP id="2" name="Chain_Genesis (Architect -> Gitea -> Developer)">
<ACTION>Архитектор создает **первое Issue** в Gitea, используя команду `create_issue`.</ACTION>
<CLI_CALL>`tea-cli issues create --title "[ARCHITECT -> DEV] {Feature Summary}" --body "{XML Work Orders}" --assignee "agent-developer" --labels "status::pending,type::development"`</CLI_CALL>
<ACTION>Архитектор создает **первое Issue** в Gitea.</ACTION>
<CLI_CALL>`./gitea-client.zsh agent-architect create-task --title "[ARCHITECT -> DEV] {Feature Summary}" --body "{XML Work Orders}" --assignee "agent-developer" --labels "status::pending,type::development"`</CLI_CALL>
</STEP>
<STEP id="3" name="Development_And_PR_Creation (Developer)">
<ACTION>1. Разработчик находит Issue (`list_issues`), меняет его статус на `status::in-progress` (`update_issue`).</ACTION>
<CLI_CALL>`tea-cli issues edit {issue-id} --remove-labels "status::pending" --add-labels "status::in-progress"`</CLI_CALL>
<ACTION>2. Создает ветку согласно **Branch Naming Convention**.</ACTION>
<ACTION>3. Реализует код, коммитит его, проверяет сборку (`./gradlew build`).</ACTION>
<ACTION>4. Создает **Pull Request** в Gitea (`create_pr`).</ACTION>
<CLI_CALL>`tea-cli pull-request create --title "PR for Issue #{issue-id}: {Feature Summary}" --body "Fixes #{issue-id}" --head "{branch_name}" --base "main"`</CLI_CALL>
<ACTION>5. Создает **новое Issue** для QA-Агента (`create_issue`).</ACTION>
<CLI_CALL>`tea-cli issues create --title "[DEV -> QA] Verify & Merge PR #{pr-id}: {Feature Summary}" --body "<PULL_REQUEST_ID>{pr-id}</PULL_REQUEST_ID>" --assignee "agent-qa" --labels "status::pending,type::quality-assurance"`</CLI_CALL>
<ACTION>6. Закрывает **свой** Issue (`close_issue`).</ACTION>
<CLI_CALL>`tea-cli issues close {issue-id}`</CLI_CALL>
<ACTION>1. Разработчик находит Issue, выполнив `./gitea-client.zsh agent-developer find-tasks --type "type::development"`.</ACTION>
<ACTION>2. Меняет его статус на `status::in-progress`.</ACTION>
<CLI_CALL>`./gitea-client.zsh agent-developer update-task-status --issue-id {issue-id} --old "status::pending" --new "status::in-progress"`</CLI_CALL>
<ACTION>3. Создает ветку согласно **Branch Naming Convention**.</ACTION>
<ACTION>4. Реализует код, коммитит его, проверяет сборку (`./gradlew build`).</ACTION>
<ACTION>5. Создает **Pull Request** в Gitea.</ACTION>
<CLI_CALL>`./gitea-client.zsh agent-developer create-pr --title "PR for Issue #{issue-id}: {Feature Summary}" --body "Fixes #{issue-id}" --head "{branch_name}"`</CLI_CALL>
<ACTION>6. Создает **новое Issue** для QA-Агента.</ACTION>
<CLI_CALL>`./gitea-client.zsh agent-developer create-task --title "[DEV -> QA] Verify & Merge PR #{pr-id}" --body "<PULL_REQUEST_ID>{pr-id}</PULL_REQUEST_ID>" --assignee "agent-qa" --labels "status::pending,type::quality-assurance"`</CLI_CALL>
<ACTION>7. Закрывает **свой** Issue (этот шаг теперь является частью `merge-and-complete` у QA-агента, но может быть и отдельным действием, если требуется).</ACTION>
</STEP>
<STEP id="4" name="Verification_And_Merge (QA Agent)">
<ACTION>1. QA-Агент находит Issue (`list_issues`), меняет статус на `status::in-progress` (`update_issue`).</ACTION>
<CLI_CALL>`tea-cli issues edit {issue-id} --remove-labels "status::pending" --add-labels "status::in-progress"`</CLI_CALL>
<ACTION>2. Извлекает `PULL_REQUEST_ID` и проводит полный аудит кода в PR.</ACTION>
<ACTION>3. **ЕСЛИ УСПЕШНО:**</ACTION>
<ACTION>1. QA-Агент находит Issue, выполнив `./gitea-client.zsh agent-qa find-tasks --type "type::quality-assurance"`.</ACTION>
<ACTION>2. Меняет статус на `status::in-progress`.</ACTION>
<CLI_CALL>`./gitea-client.zsh agent-qa update-task-status --issue-id {issue-id} --old "status::pending" --new "status::in-progress"`</CLI_CALL>
<ACTION>3. Извлекает `PULL_REQUEST_ID` и проводит полный аудит кода в PR.</ACTION>
<ACTION>4. **ЕСЛИ УСПЕШНО:**</ACTION>
<SUCCESS_PATH>
<SUB_STEP>a. Сливает (Merge) Pull Request в `main` (`merge_pr`).</SUB_STEP>
<CLI_CALL>`tea-cli pull-request merge {pr-id}`</CLI_CALL>
<SUB_STEP>b. Удаляет feature-ветку.</SUB_STEP>
<SUB_STEP>c. Закрывает свой Issue (`close_issue`). **Цикл завершен.**</SUB_STEP>
<CLI_CALL>`tea-cli issues close {issue-id}`</CLI_CALL>
<SUB_STEP>a. Выполняет атомарную операцию слияния, удаления ветки и закрытия задачи.</SUB_STEP>
<CLI_CALL>`./gitea-client.zsh agent-qa merge-and-complete --issue-id {issue-id} --pr-id {pr-id} --branch "{branch_name}"`</CLI_CALL>
</SUCCESS_PATH>
<ACTION>4. **ЕСЛИ ПРОВАЛ:**</ACTION>
<ACTION>5. **ЕСЛИ ПРОВАЛ:**</ACTION>
<FAILURE_PATH>
<SUB_STEP>a. Отклоняет Pull Request (`close_pr`).</SUB_STEP>
<CLI_CALL>`tea-cli pull-request close {pr-id}`</CLI_CALL>
<SUB_STEP>b. **Обновляет свой Issue**, возвращая его Разработчику (`update_issue`).</SUB_STEP>
<CLI_CALL>`tea-cli issues edit {issue-id} --title "[QA -> DEV] FAILED: Fix Defects in PR #{pr-id}" --assignee "agent-developer" --remove-labels "status::in-progress,type::quality-assurance" --add-labels "status::failed,type::development"`</CLI_CALL>
<RATIONALE>Это создает итеративный цикл исправления ошибок в рамках одной и той же ветки и PR.</RATIONALE>
<SUB_STEP>a. Выполняет атомарную операцию отклонения PR и возврата задачи разработчику.</SUB_STEP>
<CLI_CALL>`./gitea-client.zsh agent-qa return-to-dev --issue-id {issue-id} --pr-id {pr-id} --report "{defect_report}"`</CLI_CALL>
</FAILURE_PATH>
</STEP>
</MASTER_WORKFLOW>