Аудит делегирования в отряде

Аудит делегирования в отряде фиксирует каждое решение по делегированию, которое принимает лидер отряда — какой член был выбран, почему, какие инструкции он получил и какой контекст был предоставлен. Это создаёт прозрачный отчёт о сотрудничестве отряда и помогает диагностировать проблемы, когда делегированная задача выходит из строя.

Что регистрируется

Когда лидер отряда назначает работу члену, создаётся запись делегирования с:

Как это работает

Оценка лидером + делегирование

Когда лидер отряда оценивает работу и делегирует её:

1. Лидер анализирует задачу (через чат или брифинг)
2. Лидер решает, какого члена(ов) задействовать
3. Лидер подаёт структурированный отчёт о делегировании с:
   • Тип члена (агент или человек)
   • ID члена
   • Причина выбора (объяснение в одно предложение)
   • Резюме инструкций
   • Ссылки на контекст (ссылки на релевантные проблемы, комментарии, файлы)
4. Сервер создаёт запись о действии squad_delegation в журнал аудита
5. Делегирование появляется в представлении Аудит отряда

Комментарий @mention (читаемый человеком)

В дополнение к структурированному аудиту лидер публикует комментарий @mention в проблеме для видимости:

@frontend-builder Пожалуйста, реализуйте переключатель параметров, используя существующий компонент Switch. 
Макет находится в документе проектирования. Я привязал PR с похожей работой ниже.

Этот комментарий:

• Читаем человеком и открыт
• Легко искать и ссылаться
• Часть истории потока проблемы

Структурированное делегирование:

• Читаемо машиной и запрашиваемо
• Индексируется для аналитики
• Неизменяемо для соответствия

Оба держатся в синхронизации — комментарий предоставляет повествование, аудит предоставляет данные.

Просмотр истории делегирования

В пользовательском интерфейсе

Откройте любую проблему, назначенную отряду. В нижней части раздела Журнал выполнения вы увидите панель Делегирования отряда:

Нажмите на любую строку для:

• Просмотра полных инструкций
• Просмотра ссылок на контекст (переход к связанным проблемам, комментариям, файлам)
• Просмотра соответствующего комментария @mention в потоке

Через API

curl https://aacworkflow.example.com/api/issues/{id}/squad-delegations \
  -H "Authorization: Bearer <token>"

Возвращает:

{
  "delegations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "squad_id": "550e8400-e29b-41d4-a716-446655440001",
      "issue_id": "550e8400-e29b-41d4-a716-446655440002",
      "leader_id": "550e8400-e29b-41d4-a716-446655440003",
      "member_type": "agent",
      "member_id": "550e8400-e29b-41d4-a716-446655440004",
      "selection_reason": "Владеет фронтендом; самый быстрый путь",
      "instructions": "Реализовать переключатель параметров; использовать существующий компонент Switch",
      "context_refs": [
        "comment:550e8400-e29b-41d4-a716-446655440005",
        "issue:AAC-42",
        "file:apps/web/pages/settings.tsx"
      ],
      "created_at": "2025-06-22T15:30:00Z"
    }
  ]
}

Аналитика отряда

Перейдите на Отряды → название → Аналитика для просмотра:

• Частота делегирования — как часто выбирается каждый член
• Средняя длина инструкций — детальны или расплывчаты делегирования?
• Использованные ссылки на контекст — какие типы контекста (проблемы, комментарии, файлы) наиболее полезны
• Способности члена — выведено из паттернов делегирования (например, «Создатель фронтенда делает UI-работу на 95% времени»)

Пример: Расследование неудавшегося делегирования

Сценарий: Задача, делегированная агенту A, не удалась. Вы хотите понять, что произошло не так.

1. Перейдите в проблему и прокрутите до Делегирования отряда
2. Нажмите на делегирование для агента A
3. Вы видите:
   • Причина выбора: «Самый быстрый путь; недавняя работа над связанной функцией»
   • Инструкции: «Реализовать конечную точку API, следуя шаблону в api/issues.go»
   • Ссылки на контекст: Ссылки на пример паттерна и спецификацию проектирования
4. Нажмите на ссылки контекста для просмотра материалов, которые лидер предоставил
5. Сравните инструкции с тем, что агент A фактически сделал (видно в журнале выполнения)
6. Если инструкции были расплывчаты, неясны или отсутствуют — это подсказка

Этот журнал аудита помогает вам:

• Улучшить качество делегирования (более конкретные инструкции)
• Определить, когда контекст отсутствовал
• Дать лидеру обратную связь («ваши делегирования этому члену часто не удаются; рассмотрите больше деталей»)

Безопасность и разрешения

• Делегирования работают в рамках рабочего пространства — делегирования вашего рабочего пространства приватны
• Только члены отряда могут видеть делегирования для проблем, над которыми работает отряд
• Администраторы рабочего пространства могут аудировать все делегирования по всему рабочему пространству
• Делегирования неизменяемы — один раз записанные, они не могут быть отредактированы или удалены (для соответствия)

Структурированный формат действия

Делегирования хранятся как действия squad_delegation в журнале действий:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "action": "squad_delegation",
  "actor_type": "agent",
  "actor_id": "550e8400-e29b-41d4-a716-446655440001",  // ID лидера
  "workspace_id": "550e8400-e29b-41d4-a716-446655440002",
  "issue_id": "550e8400-e29b-41d4-a716-446655440003",
  "details": {
    "squad_id": "550e8400-e29b-41d4-a716-446655440004",
    "member_type": "agent",
    "member_id": "550e8400-e29b-41d4-a716-446655440005",
    "selection_reason": "Владеет фронтендом; самый быстрый путь",
    "instructions": "Реализовать переключатель параметров; использовать существующий компонент Switch",
    "context_refs": [
      "comment:550e8400-e29b-41d4-a716-446655440006",
      "issue:AAC-42",
      "file:apps/web/pages/settings.tsx"
    ]
  },
  "created_at": "2025-06-22T15:30:00Z"
}

Поля:

Связанные руководства

• Отряды — см. Справочник по отрядам для того, как работают команды
• Шаблоны отрядов — см. Шаблоны отрядов для заранее созданных композиций
• Журналы выполнения — см. Справочник по проблемам для того, как читать историю выполнения