Сводка

Просмотр, создание и управление циклами OKR, целями, ключевыми результатами, выравниваниями и отслеживанием прогресса.

• Восемь высокоуровневых быстрых команд для обычных операций: просмотр списков циклов и записей прогресса, получение деталей цикла и создание или обновление записей прогресса

• Полное покрытие API для сущностей OKR, включая цели, ключевые результаты, индикаторы, выравнивания и категории, с операциями создания, чтения, обновления и удаления

• Поддержка взвешенных и позиционных целей и ключевых результатов в рамках циклов, с валидацией, обеспечивающей сумму весов и уникальность позиций

• Богатые текстовые блоки контента для заметок по целям, ключевым результатам и прогрессу, с возможностью загрузки изображений для записей прогресса

• Модель разрешений на основе области действия, различающая доступ только для чтения, доступ только на запись и доступ к настройкам во всех операциях OKR

okr (v2)

КРИТИЧЕСКОЕ — Перед началом обязательно используйте инструмент Read для чтения ../lark-shared/SKILL.md，в котором содержится аутентификация и обработка прав

Идентификация: операции OKR по умолчанию используют --as user (при просмотре текущего пользователя/его подчинённых OKR). Также поддерживается просмотр OKR другого пользователя с помощью --as bot (требуются соответствующие разрешения).

Быстрые решения

Потребности пользователя Путь выполнения Справочная документация

просмотр своих/чужих OKR Получение ID пользователя -> +cycle-list -> +cycle-detail -> по необходимости поиск индикаторов/записей прогресса cycle-list, cycle-detail, indicators, progress-list

Написать себе набор OKR Сначала использовать +batch-create для создания каркаса Objective/KR batch-create, contentblock

Только добавить одну O или одну KR Используйте +create create

Редактирование содержания/заметок/сроков Используйте +patch patch

Изменение баллов OKR Только если пользователь явно упомянет «балл»/«оценка»/«score» используйте +patch --score; балл не является прогрессом/завершённостью patch

Изменение порядка или веса Используйте +reorder / +weight reorder, weight

Обновление цифрового прогресса/завершённости Проценты или числа без единиц используют +indicator-update; при необходимости изменить единицы/целевые значения сначала просмотрите индикаторы, затем используйте indicators patch indicator-update, indicators

Запись текста о прогрессе Используйте +progress-create; если текст и число заданы, можно использовать процент через --progress-percent для единообразного изменения, для единиц, не являющихся процентами, обновляйте количественные показатели progress-create, progress-list, progress-update

Выравнивание целей Обрабатывать прямо в соответствии с рабочим процессом выравнивания alignments