Перейти к содержимому
F●RGEPLAN

forgeplan_delete

Навсегда удаляет артефакт из рабочего пространства - как запись в LanceDB, так и файл markdown на диске. Это деструктивная и невосстановимая операция (без резервной копии экспорта), поэтому агентам следует настоятельно предпочитать переходы жизненного цикла (supersede, deprecate) удалению. Вызывайте forgeplan_delete только тогда, когда пользователь явно просит удалить опечатку, тестовый артефакт или дубликат.

Категория: Редактирование артефактов

Когда агент вызывает это

Заголовок раздела «Когда агент вызывает это»
  • Пользователь явно говорит: «удалить NOTE-099, я создал его по ошибке».
  • Очистка тестового артефакта из запусков forge-smoke.
  • Удаление сироты (артефакт без связей), созданного во время прерванного процесса декомпозиции.

Агентам НИКОГДА не следует вызывать это для «вывода из эксплуатации» активного решения - используйте forgeplan_supersede или forgeplan_deprecate, чтобы сохранить историю.

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

Заголовок раздела «Входные параметры»
ИмяТипОбязательныйОписание
idstringyesID артефакта для удаления.

Источник схемы: crates/forgeplan-mcp/src/server.rs::DeleteParams

Возвращает

Заголовок раздела «Возвращает»

Объект подтверждения с удалённым ID и путём файла markdown, который был отвязан. Если артефакт имел входящие ссылки от других артефактов, сервер MCP может отклонить удаление и вернуть ошибку со списком зависимых элементов, чтобы агент мог сначала их разрешить.

Пример структуры ответа:

{
  "ok": true,
  "deleted": "NOTE-099",
  "removed_path": ".forgeplan/notes/note-099-test.md"
}

Пример вызова

Заголовок раздела «Пример вызова»
{ "id": "NOTE-099" }

В типичном контексте агента:

Пользователь говорит: «PROB-099 был ошибкой, уничтожь его». Агент подтверждает с пользователем, затем удаляет.

{ "id": "PROB-099" }

Типичная последовательность

Заголовок раздела «Типичная последовательность»

forgeplan_list или forgeplan_get для подтверждения цели → явное подтверждение пользователя → forgeplan_delete → forgeplan_health для проверки отсутствия сбоев. Для обратимого вывода из эксплуатации вместо этого используется forgeplan_deprecate (active → deprecated).

Эквивалент CLI

Заголовок раздела «Эквивалент CLI»
  • forgeplan delete - та же операция, запрашивает подтверждение

См. также

Заголовок раздела «См. также»