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

forgeplan_generate

Создает новый артефакт с полностью сгенерированным текстом из описания на естественном языке. В отличие от forgeplan_new (который создает пустой шаблон-заглушку), generate использует настроенный LLM (OpenAI / Claude / Gemini / Ollama / любую совместимую с OpenAI конечную точку) для создания всех необходимых разделов за один вызов. Агент все равно должен запустить forgeplan_validate после этого, поскольку LLM может пропустить обязательные правила (MUST rules).

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

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

Заголовок раздела «Когда агент вызывает это»
  • Пользователь предоставляет подробное описание и хочет получить готовый к ревью первый черновик, а не пустую заглушку.
  • Миграция решения из истории чата в формальный ADR - используйте сводку чата в качестве описания.
  • Массовая инициализация: превращение неформальной дорожной карты в 5 черновиков PRD за одну сессию.

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

Заголовок раздела «Входные параметры»
ИмяТипОбязательныйОписание
kindstringyesТип артефакта: prd, epic, spec, rfc, adr, problem, solution, evidence.
descriptionstringyesОписание на естественном языке того, что нужно сгенерировать.

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

Возвращает

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

Идентификатор нового артефакта плюс сгенерированный текст. В отличие от forgeplan_new, агент обычно может сразу перейти к forgeplan_validate без промежуточного forgeplan_update - текст уже заполнен.

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

{
  "id": "PRD-043",
  "kind": "prd",
  "status": "draft",
  "path": ".forgeplan/prds/prd-043-oauth2-login.md",
  "body": "# PRD-043: OAuth2 login flow\n\n## Problem\n...",
  "llm": { "provider": "gemini", "model": "gemini-3-flash-preview", "tokens": 1847 }
}

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

Заголовок раздела «Пример вызова»
{ "kind": "prd", "description": "OAuth2 login flow" }

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

Пользователь вставляет описание функции в один абзац. Агент генерирует полный черновик PRD вместо пустой заглушки.

{ "kind": "prd", "description": "Add OAuth2 login with Google and GitHub, support PKCE, 15m token TTL." }

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

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

forgeplan_route (подтверждение глубины) → forgeplan_search (проверка на дубликаты) → forgeplan_generate → forgeplan_validate → (устранение пробелов через forgeplan_update) → forgeplan_reason (для Standard+) → forgeplan_activate.

Эквивалент CLI

Заголовок раздела «Эквивалент CLI»

См. также

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