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

forgeplan_route

Классифицирует входящее описание задачи по уровню глубины и рекомендует конвейер артефактов. Это первый вызов MCP в каждом нетривиальном рабочем процессе - он сообщает агенту, следует ли просто кодировать (тактическая), создать PRD → RFC (стандартная), полную цепочку PRD → Spec → RFC → ADR (глубокая) или эскалировать до Epic с межкомандным ревью (критическая). Правильный роутинг экономит часы на излишнее или недостаточное обдумывание.

Категория: Рассуждения и ИИ

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

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

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

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

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

Возвращает

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

Рекомендацию с глубиной, конвейером (список типов артефактов по порядку), уверенностью (0-1), обоснованием и альтернативами, которые агент может предложить, если пользователь не согласен. Уровень 1 (LLM) возвращает более подробное обоснование; Уровень 0 (возврат к ключевым словам) возвращает более краткую форму, но все еще пригодную для действия.

Пример формы ответа:

{
  "depth": "Standard",
  "pipeline": ["prd", "rfc"],
  "confidence": 0.85,
  "rationale": "Многофайловая функция, затрагивающая поток аутентификации; обратима в рамках спринта.",
  "alternatives": [
    { "depth": "Deep", "pipeline": ["prd", "spec", "rfc", "adr"], "when": "если криптографические примитивы изменятся" }
  ]
}

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

Заголовок раздела «Пример вызова»
{ "description": "add rate limiting to API" }

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

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

{ "description": "rewrite the LanceDB storage layer to use SQLite" }

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

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

forgeplan_route → (если тактическая) сразу перейти к коду → (если стандартная+) forgeplan_search (проверка дубликатов) → forgeplan_new → forgeplan_update → forgeplan_validate → forgeplan_reason. Роутинг дёшев; вызывайте его всякий раз, когда задача кажется неоднозначной.

Эквивалент CLI

Заголовок раздела «Эквивалент CLI»
  • forgeplan route - тот же классификатор, вывод для человека

См. также

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