Удаление задачи через MCP: необратимые действия и запросы подтверждения

Справочник разработчика по MCP-инструменту delete_task. Узнайте об этой необратимой операции, поймите, когда её использовать, и внедрите надёжные шаблоны подтверждения, чтобы предотвратить случайные удаления. Включает примеры вызовов инструмента, запросы на естественном языке, краевые случаи и устранение неполадок.

Обзор инструмента

Назначение

Инструмент delete_task безвозвратно удаляет задачу из вашего рабочего пространства Workify. Это действие нельзя отменить.

⚠️⚠️ Разрушительная операция: этот инструмент безвозвратно удаляет данные. Всегда используйте надёжные шаблоны подтверждения и просматривайте задачу перед удалением.

⚠️ Предупреждение

Удаление задачи необратимо. Удалённые задачи не подлежат восстановлению. Всегда проверяйте, что удаляете правильную задачу, и требуйте явного подтверждения (например, «DELETE CONFIRM» — оба слова).

Входные параметры

Инструменту требуется только идентификатор удаляемой задачи.

Формат вывода

При успешном удалении инструмент возвращает подтверждение:

{
  "success": true,
  "message": "Task deleted successfully",
  "deleted_task_id": 123
}

Шаблоны безопасности: требуется надёжное подтверждение

⚠️ Всегда используйте надёжное подтверждение

Удаление необратимо. Используйте эти обязательные шаблоны:

• Сначала предпросмотр: всегда вызывайте get_task, чтобы показать детали задачи
• Явное предупреждение: предупредите пользователя, что удаление необратимо
• Надёжный токен: требуйте «DELETE CONFIRM» (оба слова), а не просто «CONFIRM»
• Проверка задачи: покажите название и ID задачи перед удалением

Подробнее о безопасных рабочих процессах записи →

Шаблон безопасного запроса

✅ Шаблон безопасного запроса:

"Я хочу удалить задачу [название задачи].

Правила:
1. Сначала вызови get_task, чтобы показать мне детали задачи
2. Предупреди меня, что удаление необратимо и не может быть отменено
3. Дождись, пока я введу DELETE CONFIRM (оба слова), прежде чем вызывать delete_task
4. Если я не введу DELETE CONFIRM, ничего не удаляй"

Примеры вызовов инструмента

Пример: удаление задачи

Вызов инструмента (JSON):

{
  "tool": "delete_task",
  "arguments": {
    "task_id": 123
  }
}

Возвращает: подтверждение того, что задача удалена

⚠️ Предупреждение: это безвозвратно удаляет задачу. Всегда подтверждайте заранее!

Примеры запросов на естественном языке

Безопасное удаление с надёжным подтверждением

Запрос пользователя:

"Удали дублирующуюся задачу 'Test login'. Сначала покажи мне задачу, предупреди, что это необратимо, затем дождись DELETE CONFIRM."

Поведение ИИ:

1. ИИ вызывает get_task, чтобы показать детали задачи
2. ИИ отображает: «Задача #123: Test login (дубликат)»
3. ИИ предупреждает: «⚠️ Это безвозвратно удалит эту задачу. Отменить нельзя.»
4. ИИ спрашивает: «Введите DELETE CONFIRM (оба слова), чтобы удалить эту задачу»
5. Пользователь вводит «DELETE CONFIRM»
6. ИИ вызывает delete_task только после точного подтверждения
7. ИИ подтверждает, что задача удалена

Чего НЕ следует делать

❌ Небезопасный запрос:

"Удали задачу 123"

Почему это небезопасно:

• Нет предпросмотра того, что будет удалено
• Нет предупреждения о необратимости
• Слабое подтверждение (или его отсутствие)
• Высокий риск случайного удаления

Когда использовать удаление

Удаление задач должно быть редким. Сначала рассмотрите эти альтернативы:

✅ Альтернативы удалению:

• Пометить как выполненную: используйте update_task, чтобы установить status="done"
• Архивировать: переместите на доску или в проект «Архив»
• Закрыть: обновите статус и добавьте завершающий комментарий
• Отменить: обновите статус на "blocked" с пояснением

⚠️ Когда удаление уместно:

• Настоящие дубликаты: удаление точных дублирующихся задач
• Тестовые задачи: очистка тестовых/экспериментальных задач
• Ошибки: задачи, созданные по ошибке
• Очистка данных: удаление устаревших или недействительных задач

Распространённые сценарии использования

• Груминг бэклога — удаление устаревших или неактуальных задач из бэклога
• Обнаружение дубликатов — удаление дублирующихся задач после слияния
• Управление задачами — очистка задач в рамках рабочего процесса управления задачами

Краевые случаи

Задача не найдена (404)

Ситуация: task_id не существует или уже был удалён

Ответ:

{
  "error": "not_found",
  "message": "Task with ID 123 not found"
}

Обработка: проверьте правильность ID задачи, либо задача, возможно, уже была удалена

Доступ запрещён (403)

Ситуация: задача существует, но у вас нет прав на её удаление

Ответ:

{
  "error": "forbidden",
  "message": "You don't have permission to delete this task"
}

Обработка: проверьте права на задачу в Workify

Прочитать руководство по устранению ошибки 403 →

У задачи есть зависимости

Ситуация: задача может быть связана с другими задачами или иметь учёт времени

Ответ: задача удаляется, но связанные данные могут быть затронуты (подробности см. в документации Workify)

Обработка: просмотрите связи задачи перед удалением, если это важно

Устранение неполадок

Задача не найдена (404)

Симптом: ошибка 404 Not Found при попытке удаления

Причины:

• task_id не существует
• Задача уже была удалена
• Неверный формат task_id

Решение:

• Проверьте правильность task_id
• Используйте list_tasks или get_task, чтобы найти действительные ID
• Проверьте, существует ли задача

Доступ запрещён (403)

Симптом: ошибка 403 Forbidden

Причины:

• Задача принадлежит другому рабочему пространству
• У вас нет прав на удаление
• Задача защищена или заблокирована

Решение:

• Убедитесь, что вы в правильном рабочем пространстве
• Проверьте права на задачу в Workify
• При необходимости обратитесь к администратору рабочего пространства

Прочитать руководство по устранению ошибки 403 →

Лучшие практики

Безопасное использование delete_task

• ✅ Всегда сначала вызывайте get_task, чтобы просмотреть, что будет удалено
• ✅ Показывайте пользователю название и ID задачи перед удалением
• ✅ Предупреждайте пользователя, что удаление необратимо и не может быть отменено
• ✅ Требуйте надёжный токен подтверждения: «DELETE CONFIRM» (оба слова)
• ✅ Рассмотрите альтернативы (пометка как выполненной, архивирование) перед удалением
• ✅ Удаляйте только настоящие дубликаты, тестовые задачи или ошибки
• ✅ Проверяйте правильность task_id перед удалением
• ✅ Никогда не удаляйте пакетно без показа полного списка и требования «DELETE CONFIRM ALL»

Связанные инструменты

Часто используются вместе с:

• get_task — предпросмотр деталей задачи перед удалением (обязательно)
• list_tasks — поиск задач для удаления (например, дубликатов)
• update_task — рассмотрите обновление статуса вместо удаления
• Рабочие процессы с минимальными привилегиями — безопасные шаблоны рабочих процессов записи