Ваши агенты пишут спеки.Вы доводите их до ума в DotMD.

Почему чат плохо подходит для ревью

Агент пишет спеку за минуту. Внимательно прочитать её и довести до ума по-прежнему вам, а чат для этого неудобен. Вы цитируете абзац и объясняете, что хотите, агент переписывает полфайла, и вы не понимаете, что изменилось. Следующий круг начинается с тех же догадок.

Проверяйте спеку так, как проверяете код. В DotMD каждый комментарий привязан к своему фрагменту, правка появляется в файле рядом с ним, и каждая версия файла сохраняется.

Цикл ревью

1. Агент присылает вам файл

   Он пишет спеку и присылает её на ревью. Уведомление сообщает вам об этом, файл ждёт в боковой панели в разделе Needs You, и агент тоже ждёт.

2. Вы комментируете фрагменты

   Читайте документ в том виде, в каком он будет выглядеть: с таблицами, диаграммами и кодом. Выделите фрагмент, который нужно изменить, нажмите ⌥⌘M и напишите, что хотите. Пройдите весь файл, прежде чем что-то отправлять.

3. Вы нажимаете Send

   Нажмите Send внизу панели Review. Агент получит все комментарии разом, каждый с фрагментом и номерами строк.

4. Правки появляются в файле

   Агент редактирует файл и возвращает каждый комментарий с заметкой о том, что сделал. Старый текст красный, новый зелёный, рядом с комментарием, на который он отвечает.

5. Вы принимаете или возвращаете, затем одобряете

   Accept принимает правку, Reopen возвращает её с более точной заметкой, Accept All принимает всё. Когда менять больше нечего, нажмите Approve, и агент продолжит свою задачу.

Что стоит проверять так

Всё, что агент пишет в виде Markdown-файла и что нужно довести до ума, прежде чем он начнёт действовать:

• Спеки и дизайн-документы для фичи.
• Планы реализации, до того как агент напишет код.
• Планы миграции и выкатки, где пропущенный шаг дорого стоит.
• README и документация, по которым будут работать другие.
• Сравнительные таблицы, где каждая строка может быть неверной сама по себе.

Комментарии работают и вовсе без агента, как заметки себе на черновике.

Ничто не повисает незамеченным

Агента, который ждёт вас, легко забыть. DotMD держит его на виду, не вмешиваясь в то, чем вы заняты:

• Needs You вверху боковой панели перечисляет каждый файл, где вас кто-то ждёт: агент ждёт вашего ревью или есть правки, которые вы ещё не проверили.
• Значок в Dock показывает, сколько файлов ждут вас.
• В файле баннер сообщает, что ждёт, с кнопкой Review, а кнопка Review на панели инструментов показывает красным число правок на проверку.
• Агент ждёт в одном вызове и не тратит токены, пока вы читаете, сколько бы это ни длилось.

Что вам нужно

• Mac с macOS 14 или новее.
• DotMD Pro для ревью и агентов: Yearly с 3 днями бесплатного пробного периода или Lifetime. Чтение Markdown бесплатно. См. цены.
• Агент с поддержкой MCP, подключённый к DotMD. В руководствах по Claude Code и Codex настройка для каждого занимает одну строку.

Вопросы о ревью ИИ-спек

Другие вопросы