Меню документации

Пользовательские истории и наборы планирования

На этой странице

Чтобы описать поведение, которое можно проверить на практике, используйте конкретную историю. Набор планирования применяйте, если он подходит для проекта.

Использование инструментов

  1. Сначала вызовите подходящий инструмент чтения или проверки статуса.
  2. Проверьте целевой объект и обязательные аргументы.
  3. Выполните одно намеченное действие, получив явное подтверждение человека там, где оно требуется.
  4. После этого проверьте статус или повторно прочитайте затронутый ресурс.

Описанные ниже входные параметры задают публичный контракт. Ориентируйтесь на текущий список инструментов подключённого сервера. Некоторым инструментам нужны определённый хост, целевой объект, режим инференса или план. Используйте идентификаторы, полученные от ранее вызванных инструментов; не придумывайте их.

describe_planning_kits

Наборы планирования, которые можно применить к проекту.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| projectId | Нет | строка |

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

apply_planning_kit

Запишите набор планирования в проект.

Сначала прочитайте результат describe_planning_kits. Выберите поддерживаемый набор планирования и набор типов. Затем проверьте созданные истории.

АргументОбязательныйТип или допустимые значения

| projectId | Нет | строка |

| kit | Да | строка; минимальная длина 1 |

| types | Нет | массив строк |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

list_stories

Пользовательские истории проекта.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| projectId | Нет | строка |

| page | Нет | целое число; минимум 0; максимум 9007199254740991 |

| size | Нет | целое число; минимум 1; максимум 100 |

| status | Нет | строка |

| area | Нет | строка |

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

search_stories

Найдите историю.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| q | Да | строка; минимальная длина 1 |

| projectId | Нет | строка |

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

create_story

Добавьте пользовательскую историю.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| story | Да | строка; минимальная длина 1 |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

update_story

Измените формулировку пользовательской истории.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| story | Да | строка; минимальная длина 1 |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

delete_story

Удалите пользовательскую историю.

Удаляет историю из плана. Прежде чем удалить историю, проверьте карточку. Удаление истории не гарантирует, что существующий код приложения будет отменён.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу; возможны разрушительные последствия.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

develop_story

Реализуйте пользовательскую историю.

Однократно запускает разработку выбранной истории. Отслеживайте story_status и проверьте результат в предварительном просмотре.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

reset_story

Верните историю в статус «Запланирована».

Меняет статус истории на «Запланирована». Прежде чем запустить её снова, проверьте текущее состояние приложения.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

complete_story

Отметьте историю как завершённую.

Обновляет состояние в плане. Проверьте реализованное поведение; само по себе это действие не добавляет недостающий код.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| projectId | Нет | строка |

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

story_status

Что произошло с историей.

Прочитайте возвращённый ресурс и используйте его текущие значения при планировании следующего действия.

АргументОбязательныйТип или допустимые значения

| storyId | Да | строка |

| projectId | Нет | строка |

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; размещённый HTTP-сервер.

Машиночитаемые контракты инструментов содержат схемы вложенных аргументов.

Связанные справочные материалы

Главная страница MCP · Порядок восстановления работы · Стоимость