add_dependency_draft
ChatGPTПредложить связь между задачами: BLOCKS — эта держит другую, BLOCKED_BY — другая держит эту, RELATES_TO — просто связаны, DUPLICATES / DUPLICATED_BY — дубль. Создаёт черновик, связь при этом НЕ создаётся.
attach_file
ChatGPTПриложить файл к задаче (только к задаче): скриншот, лог, дамп. Два шага: 1) key задачи или draft_id своего черновика задачи, file_name, size_bytes, content_type — придёт команда curl, выполни её с путём к файлу; 2) attachment_id и uploaded=true. К черновику файл придёт вместе с подтверждённой задачей; к существующей задаче — только с «Без подтверждения».
broken_links
ChatGPTСсылки [[…]] проекта, которые никуда не ведут, — одним списком по цели: сколько раз, где стоят и похожие существующие названия (suggestions). Используй после переноса базы или переименований, вместо того чтобы открывать документы по одному.
cancel_drafts
ChatGPTОтозвать свои черновики, которые ещё ждут подтверждения человека: ошибся, передумал, задача уже не нужна. Без draft_ids — список ожидающих с id. Отменённое остаётся в истории.
confirm_memory
ChatGPTОтметить, что решение или заметка сверены с кодом и верны: после git log <commit>..HEAD -- <paths> из поля code. Неверна — не подтверждай, а поправь: remember с supersedes или edit_document. commit — текущий HEAD.
create_document
ChatGPTСоздать документ проекта в папке по пути (folder: «Спецификации/API»; недостающие папки создаются, пусто — корень). Для решений, причин сбоев и приёмов лучше remember; этот инструмент — для спецификаций, инструкций, заметок со встреч. Ссылайся на связанное: [[Название документа или решения]], [[KEY-42]] — задача; ссылки станут связями.
create_subtasks_draft
ChatGPTПредложить разбиение задачи на подзадачи. Создаёт черновик.
create_task_draft
ChatGPTПредложить новую задачу. Создаёт черновик, который пользователь подтверждает вручную. Задача при этом НЕ создаётся. Ответственного называй именем; не указан — им станет тот, кто просит.
edit_document
ChatGPTПоправить документ точечно: заменить кусок old_text на new_text. old_text — дословно из get_document и встречается ровно один раз; без old_text new_text дописывается в конец. Несколько мест — одним вызовом в edits, а не серией вызовов. version — из get_document. why обязателен: это сообщение версии, его видят люди в истории. Правка сразу становится версией, её можно вернуть. Ссылки [[…]] по всему проекту чини relink, а не здесь.
get_decision
ChatGPTРешение по id (из search_knowledge, get_task, backlinks): суть, причина, статус и связи — links, куда оно ссылается, backlinks — что опирается на него.
get_document
ChatGPTТекст документа целиком, его папка, version (нужна для edit_document) и связи: links — куда ссылается [[…]], backlinks — кто ссылается сюда.
get_project_health
ChatGPTЗдоровье проекта: статус, метрики и сработавшие правила с готовыми формулировками. Пересказывай их, но не придумывай свой статус и числа.
get_project_members
ChatGPTУчастники проекта и их роли
get_project_stats
ChatGPTСчётчики задач проекта по статусам и число просроченных
get_task
ChatGPTКарточка задачи по ключу (REP-42): описание, последние комментарии, решения, коммиты и mentioned_in — документы и решения, которые на неё ссылаются
get_task_history
ChatGPTИстория изменений задачи: смены статуса, переносы срока, правки полей
link_commits
ChatGPTПривязать коммиты к задачам — задача покажет, каким кодом её сделали. Задача берётся из строки «Revision: RV-42» в сообщении коммита или из keys. Коммиты возьми сам: git log --format='%H%x1f%an%x1f%aI%x1f%B%x1e'; repository — git remote get-url origin. Вызывай после коммита по задаче; повтор безопасен. С files ответ назовёт решения и заметки, чей код коммит поменял (code_changed).
list_decisions
ChatGPTВсе решения проекта списком: id, название, статус, дата — полный, а не выдача поиска. По умолчанию действующие (принятые и предложенные); status — accepted, proposed, revoked (отменены), superseded (заменены), all. contains — слово в названии. Суть и причина — get_decision.
list_documents
ChatGPTОглавление документов проекта: названия по папкам. Открыть — get_document по названию. folder — только эта папка. По словам — search_knowledge.
list_my_tasks
ChatGPTЗадачи текущего пользователя по разделу: active, today, upcoming, overdue, high_priority, blocked, waiting, completed
list_projects
ChatGPTПроекты, к которым есть доступ: id, название, ключ задач и ссылка на проект.
relink
ChatGPTПеревести ссылку [[from]] на [[to]] сразу во всех документах и решениях проекта; to пусто — ссылка станет обычным текстом. Подпись и #раздел сохраняются, код не трогается. Каждый документ получает версию с причиной why. Один вызов на цель — вместо edit_document по каждому документу.
remember
ChatGPTЗаписать в память проекта то, что стало ясно по ходу работы: принятое решение (kind=decision), найденную причину сбоя (debugging), повторяемый приём (pattern) или наблюдение (observation). Записывается сразу, без подтверждения. Вызывай в момент, когда понял, а не в конце работы. В body ссылайся на связанное: [[Название]] документа или решения, [[KEY-42]] задачи. Заголовок — утверждение, а не тема: «Выкладка через rsync, а не Git», не «Деплой». Если в проекте уже есть папка по теме (list_documents), клади заметку туда через folder. Решение сверяется с принятыми: если сервер вернул similar_decisions, повтори с supersedes (новое заменяет старое) или checked=true (это о другом).
search_knowledge
ChatGPTПоиск по знаниям: тексты задач, комментарии, документы и решения проекта. Используй для вопросов «почему», «как решили», «что обсуждали».
search_tasks
ChatGPTСписок задач по структурным признакам: статус, ожидание. Используй для вопросов «что в работе», «что заблокировано».
set_decision_status
ChatGPTСменить статус решения без нового решения: revoked — отменили и замены нет («функцию убрали»), proposed — вернуть в обсуждение, accepted — принять. why обязателен, он допишется в решение. Новое решение вместо старого — не здесь, а remember с supersedes.
update_task_draft
ChatGPTПредложить изменение задачи: заголовок, описание, приоритет, срок, статус, ответственный, исполнители, наблюдатели, метки, оценка, ожидание. Людей, статусы и метки называй именами — идентификаторы не нужны; присылай только то, что меняешь: пустое значение ничего не стирает, для стирания есть clear. если имя подойдёт нескольким, инструмент вернёт варианты, переспроси. Если задача ждёт чего-то внешнего (доступа, ключа, ответа) — ставь is_waiting и waiting_reason, а НЕ пиши это в описание: у ожидания свой раздел в «Моей работе». Если задачу держит другая задача — используй add_dependency_draft.
what_changed
ChatGPTЧто изменилось в проектах с прошлого визита: новые и принятые решения, созданные, закрытые и сдвинутые задачи, правленые документы, кто пришёл и ушёл из проекта. Вызывай в начале работы, до того как опираться на то, что помнишь. Без since считает от прошлого визита этого подключения. Кратко: до 10 в группе, перенесённое из файлов — числом; kind — вся группа, detail — с причинами.