Перейти к содержанию
Меню документации

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

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

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

Как пользоваться инструментами

  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 · Процесс восстановления работы · Стоимость