refactor promts

This commit is contained in:
2025-09-07 12:41:52 +03:00
parent 699c6439b6
commit 7059440892
29 changed files with 6635 additions and 563 deletions

View File

@@ -0,0 +1,74 @@
<!-- File: agent_promts/implementations/filesystem_task_channel.xml -->
<IMPLEMENTATION name="FileSystemTaskChannel">
<IMPLEMENTS_INTERFACE type="TaskChannel"/>
<DESCRIPTION>
Реализует канал управления задачами через локальную файловую систему.
Задачи хранятся как файлы в директории `tasks/`.
</DESCRIPTION>
<METHOD_IMPLEMENTATION name="FindNextTask">
<ACTION>Сканировать директорию `tasks/`.</ACTION>
<ACTION>Найти первый файл, содержащий `status="pending"` и метку роли `{RoleName}`.</ACTION>
<ACTION>Если найден, вернуть содержимое файла. Иначе, вернуть `NULL`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreateTask">
<ACTION>Создать новый XML-файл в директории `tasks/`.</ACTION>
<ACTION>Имя файла: `{Timestamp}_{Title}.xml`.</ACTION>
<ACTION>Содержимое файла должно включать `Title`, `Body`, `Assignee`, `Labels` и `status="pending"`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="UpdateTaskStatus">
<ACTION>Найти файл задачи по `{IssueID}` (имени файла).</ACTION>
<ACTION>Заменить в файле `status="{OldStatus}"` на `status="{NewStatus}"`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="AddComment">
<ACTION>Найти файл задачи по `{IssueID}`.</ACTION>
<ACTION>Добавить в конец файла XML-блок `<COMMENT timestamp="..." author="...">{CommentBody}</COMMENT>`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreatePullRequest">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'CreatePullRequest' не поддерживается файловым протоколом. Пропущено.
Title: {Title}, Head: {HeadBranch}, Base: {BaseBranch}
</LOG>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="MergeAndComplete">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'MergeAndComplete' не поддерживается файловым протоколом. Пропущено.
IssueID: {IssueID}, PrID: {PrID}
</LOG>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="ReturnToDev">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'ReturnToDev' не поддерживается файловым протоколом. Пропущено.
IssueID: {IssueID}, PrID: {PrID}
</LOG>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CommitChanges">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'CommitChanges' не поддерживается файловым протоколом. Пропущено.
Commit Message: {CommitMessage}
</LOG>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreateBranch">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'CreateBranch' не поддерживается файловым протоколом. Пропущено.
Branch Name: {BranchName}
</LOG>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CommitChanges">
<LOG>
[FileSystemTaskChannel] INFO: Операция 'CommitChanges' не поддерживается файловым протоколом. Пропущено.
Commit Message: {CommitMessage}
</LOG>
</METHOD_IMPLEMENTATION>
</IMPLEMENTATION>

View File

@@ -1,38 +0,0 @@
<IMPLEMENTATION name="FileSystemTaskSource">
<IMPLEMENTS_INTERFACE type="TaskSource"/>
<DESCRIPTION>
Реализует канал получения задач через сканирование директории 'tasks/'
на наличие файлов со статусом 'pending'.
</DESCRIPTION>
<METHOD_IMPLEMENTATION name="GetNextPendingTask">
<OPERATIONAL_LOOP name="FindPendingTask">
<STEP id="1" name="List_Files_In_Tasks_Directory">
<ACTION>Выполни команду `ReadFolder` для директории `tasks/`.</ACTION>
<ACTION>Сохрани результат в переменную `task_files_list`.</ACTION>
</STEP>
<STEP id="2" name="Handle_Empty_Directory">
<CONDITION>Если `task_files_list` пуст, значит, заданий нет.</CONDITION>
<ACTION>Вернуть `NULL`.</ACTION>
</STEP>
<STEP id="3" name="Iterate_And_Find_First_Pending_Task">
<LOOP variable="filename" in="task_files_list">
<SUB_STEP id="3.1" name="Read_File_With_Hierarchical_Fallback">
<!-- ... Полная логика чтения файла ... -->
</SUB_STEP>
<SUB_STEP id="3.2" name="Check_Status_And_Process_Task">
<CONDITION>Если `file_content` НЕ пуста И содержит `status="pending"`,</CONDITION>
<ACTION>Вернуть `file_content`.</ACTION>
</SUB_STEP>
</LOOP>
</STEP>
<STEP id="4" name="Handle_No_Pending_Tasks_Found">
<ACTION>Вернуть `NULL`.</ACTION>
</STEP>
</OPERATIONAL_LOOP>
</METHOD_IMPLEMENTATION>
</IMPLEMENTATION>

View File

@@ -1,26 +0,0 @@
<IMPLEMENTATION name="GiteaIssueTaskSource">
<IMPLEMENTS_INTERFACE type="TaskSource"/>
<USES_PROTOCOL name="GiteaIssueDrivenProtocol"/>
<DESCRIPTION>
Реализует канал получения задач через поиск открытых issues в Gitea,
используя `gitea-client.zsh`.
</DESCRIPTION>
<METHOD_IMPLEMENTATION name="GetNextPendingTask">
<INPUT>RoleName</INPUT>
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} find-tasks --type "type::development"`
для поиска доступных задач для указанной роли.
</ACTION>
<ACTION>
Если найдена одна или несколько задач, взять первую из списка.
</ACTION>
<ACTION>
Извлечь содержимое задачи (WorkOrder) и вернуть его.
</ACTION>
<ACTION>
Если задачи не найдены, вернуть `NULL`.
</ACTION>
</METHOD_IMPLEMENTATION>
</IMPLEMENTATION>

View File

@@ -0,0 +1,69 @@
<!-- File: agent_promts/implementations/gitea_task_channel.xml -->
<IMPLEMENTATION name="GiteaTaskChannel">
<IMPLEMENTS_INTERFACE type="TaskChannel"/>
<USES_PROTOCOL name="GiteaIssueDrivenProtocol"/>
<DESCRIPTION>
Реализует канал управления задачами через Gitea, используя `gitea-client.zsh`.
</DESCRIPTION>
<METHOD_IMPLEMENTATION name="FindNextTask">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} find-tasks --type "{TaskType}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreateTask">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} create-task --title "{Title}" --body "{Body}" --assignee "{Assignee}" --labels "{Labels}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="UpdateTaskStatus">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} update-task-status --issue-id {IssueID} --old "{OldStatus}" --new "{NewStatus}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreatePullRequest">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} create-pr --title "{Title}" --body "{Body}" --head "{HeadBranch}" --base "{BaseBranch}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="MergeAndComplete">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} merge-and-complete --issue-id {IssueID} --pr-id {PrID} --branch "{BranchToDelete}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="ReturnToDev">
<ACTION>
Выполнить команду `./gitea-client.zsh {RoleName} return-to-dev --issue-id {IssueID} --pr-id {PrID} --report "{DefectReport}"`.
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="AddComment">
<ACTION>
<!-- gitea-client.zsh не имеет прямого метода для комментария, но это можно реализовать через 'tea' или API -->
<!-- Для совместимости с интерфейсом, пока логируем -->
<LOG>ACTION: AddComment. Issue: {IssueID}, Body: {CommentBody}</LOG>
</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CommitChanges">
<ACTION>Выполнить `git add .`.</ACTION>
<ACTION>Выполнить `git commit -m "{CommitMessage}"`.</ACTION>
<ACTION>Выполнить `git push origin {CurrentBranch}`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CreateBranch">
<ACTION>Выполнить `git checkout -b {BranchName}`.</ACTION>
</METHOD_IMPLEMENTATION>
<METHOD_IMPLEMENTATION name="CommitChanges">
<ACTION>Выполнить `git add .`.</ACTION>
<ACTION>Выполнить `git commit -m "{CommitMessage}"`.</ACTION>
<ACTION>Выполнить `git push origin {CurrentBranch}`.</ACTION>
</METHOD_IMPLEMENTATION>
</IMPLEMENTATION>