forgeplan_estimate

Оценивает трудозатраты (в часах) для артефакта путем анализа его чекбоксов функциональных требований и этапов реализации, затем применяя профиль с несколькими грейдами (Junior / Middle / Senior / Principal / AI). Возвращает разбивку по грейдам с оценкой достоверности, опционально используя оценку сложности на основе LLM или ручные переопределения.

Категория: Качество

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

• Планирование спринта - получить часы для каждого PRD / RFC до фиксации объема работ.
• Сопоставление грейдов - посмотреть, сколько часов занимает задача для вашего собственного грейда с помощью my_grade.
• Планы с помощью ИИ - grade: "ai" применяет множители ИИ (обычно 0.03–0.4× от Senior) для задач, которые можно делегировать.
• Цикл обратной связи для калибровки - сравнить фактические и оценочные значения после спринта, чтобы настроить профиль.

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

Имя	Тип	Обязательный	Описание
id	string	yes	ID артефакта для оценки.
grade	string	no	Переопределить грейд для всех пунктов: junior, middle, senior, principal, ai.
my_grade	bool	no	Автоматически определить грейд из конфигурации grade_profile + вывод домена артефакта.
llm_score	bool	no	Использовать оценку сложности на основе LLM вместо эвристики, основанной на правилах.
complexity	string	no	Ручные переопределения сложности, например "FR-001=5,FR-002=3".

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

Возвращает

{
  "id": "PRD-039",
  "total_items": 12,
  "by_grade": {
    "junior": { "hours": 96, "confidence": 0.6 },
    "middle": { "hours": 52, "confidence": 0.75 },
    "senior": { "hours": 28, "confidence": 0.85 },
    "principal": { "hours": 18, "confidence": 0.8 },
    "ai": { "hours": 4.2, "confidence": 0.5 }
  },
  "breakdown": [
    { "item": "FR-001", "complexity": 3, "senior_hours": 4 }
  ]
}

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

{ "id": "PRD-039", "my_grade": true }

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

1. forgeplan_estimate с my_grade: true - получить личные часы.
2. Сравнить с пропускной способностью спринта - при необходимости уменьшить объем работ.
3. После спринта: внести фактические данные и оценки обратно в конфигурацию grade_profile.

Эквивалент CLI

forgeplan estimate PRD-039 --my-grade
forgeplan estimate PRD-039 --grade ai

См. также

• forgeplan_calibrate - предложение глубины (используется для оценки).
• forgeplan_progress - фактический процент выполнения по сравнению с оценкой.
• Руководство по методологии