GoDD MCP α

Документация GoDD MCP α

От первой настройки до ежедневной разработки, проверки качества и выпуска. Выберите цель и начните с готового примера.

Начало работы

Подготовьте требования и выполните четыре команды по порядку.

Требуется лицензионный ключ

Для GoDD MCP α нужен действующий ключ GoDD. Одной лицензии достаточно для обычных функций; отдельный ключ аудита выпускать не нужно.

  1. Выберите тариф и создайте аккаунт
  2. Оформите подписку
  3. Выпустите ключ в панели управления

Три шага для старта

Требуются Node.js 22+ и Cursor, Claude Code, Codex, Kimi CLI или Antigravity.

npm install -g @autodevjapan/godd-mcp-alpha
godd-a install --license-key=YOUR_LICENSE_KEY
godd-a init
/godd-a/dev Добавь редактирование профиля

Выберите цель

Выберите типовой сценарий, чтобы увидеть следующие команды.

Создать и выпустить функцию

Уточните требования, реализуйте, проверьте качество и передайте на review.

  1. 1/godd-a/dev
  2. 2/godd-a/check
  3. 3/godd-a/ship

Безопасно исправить дефект

Исследуйте влияние, добавьте тест воспроизведения и исключите регрессию.

  1. 1/godd-a/impact
  2. 2/godd-a/test
  3. 3/godd-a/check

Объяснить и поделиться изменением

Обновите документацию, проверьте результат и создайте pull request.

  1. 1/godd-a/docs
  2. 2/godd-a/review
  3. 3/godd-a/pr

Полный справочник функций

Откройте команду, чтобы увидеть сценарий, условия, пример, результат и решение проблем.

Разработка и качество

/godd-a/dev/godd-a-devПоэтапно проводит через требования, реализацию, тесты, качество и документацию.
Что делает
Поэтапно проводит через требования, реализацию, тесты, качество и документацию.
Когда использовать
Используйте для функции или исправления, которым нужны план и проверка.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Показываются область изменения, реализация и результаты проверок.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Показываются область изменения, реализация и результаты проверок.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/dev Добавь повтор при ошибке входа

Что использовать дальше

/godd-a/check/godd-a/ship
/godd-a/check/godd-a-checkПроверяет спецификацию, тесты, типы, lint и безопасность.
Что делает
Проверяет спецификацию, тесты, типы, lint и безопасность.
Когда использовать
Используйте перед коммитом или передачей на review.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните изменённые файлы и доступные в проекте команды проверки.
Ожидаемый результат
Для каждой проверки приводится результат PASS, FAIL или INCONCLUSIVE.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните изменённые файлы и доступные в проекте команды проверки. Если результат не соответствует описанию «Для каждой проверки приводится результат PASS, FAIL или INCONCLUSIVE.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/check

Что использовать дальше

/godd-a/test/godd-a/review
/godd-a/ship/godd-a-shipПроводит готовое изменение через проверку, commit, push и pull request.
Что делает
Проводит готовое изменение через проверку, commit, push и pull request.
Когда использовать
Используйте, когда изменение готово к review.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте Git remote, вход в GitHub и права на целевую ветку.
Ожидаемый результат
После успешных проверок создаются опубликованная ветка и PR.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте Git remote, вход в GitHub и права на целевую ветку. Если результат не соответствует описанию «После успешных проверок создаются опубликованная ветка и PR.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/ship

Что использовать дальше

/godd-a/pr/godd-a/deploy
/godd-a/review/godd-a-reviewПроверяет качество, дизайн, безопасность и эксплуатацию изменения.
Что делает
Проверяет качество, дизайн, безопасность и эксплуатацию изменения.
Когда использовать
Используйте перед PR или для независимой оценки.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните изменённые файлы и доступные в проекте команды проверки.
Ожидаемый результат
Замечания получают приоритет, доказательства и варианты исправления.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните изменённые файлы и доступные в проекте команды проверки. Если результат не соответствует описанию «Замечания получают приоритет, доказательства и варианты исправления.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/review

Что использовать дальше

/godd-a/check/godd-a/commit
/godd-a/test/godd-a-testСоздаёт или запускает тесты, необходимые для изменения.
Что делает
Создаёт или запускает тесты, необходимые для изменения.
Когда использовать
Используйте для воспроизведения дефекта и защиты от регрессии.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните изменённые файлы и доступные в проекте команды проверки.
Ожидаемый результат
Показываются команды, код завершения и причины ошибок.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните изменённые файлы и доступные в проекте команды проверки. Если результат не соответствует описанию «Показываются команды, код завершения и причины ошибок.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/test Добавь регрессионный тест повторного входа

Что использовать дальше

/godd-a/check/godd-a/e2e

GitHub и релизы

/godd-a/commit/godd-a-commitФиксирует проверенные изменения осмысленным коммитом.
Что делает
Фиксирует проверенные изменения осмысленным коммитом.
Когда использовать
Используйте после завершения одной цели и её тестов.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните изменённые файлы и доступные в проекте команды проверки.
Ожидаемый результат
Только нужный diff фиксируется с понятным сообщением.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните изменённые файлы и доступные в проекте команды проверки. Если результат не соответствует описанию «Только нужный diff фиксируется с понятным сообщением.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/commit

Что использовать дальше

/godd-a/push
/godd-a/push/godd-a-pushОтправляет текущую ветку в настроенный remote.
Что делает
Отправляет текущую ветку в настроенный remote.
Когда использовать
Используйте для публикации коммитов или подготовки PR.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте Git remote, вход в GitHub и права на целевую ветку.
Ожидаемый результат
Показываются целевая ветка и результат push.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте Git remote, вход в GitHub и права на целевую ветку. Если результат не соответствует описанию «Показываются целевая ветка и результат push.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/push

Что использовать дальше

/godd-a/pr
/godd-a/pr/godd-a-prСоздаёт pull request по шаблону репозитория.
Что делает
Создаёт pull request по шаблону репозитория.
Когда использовать
Используйте, когда ветка готова к review.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте Git remote, вход в GitHub и права на целевую ветку.
Ожидаемый результат
Создаётся PR с итогом, тестами и связанной Issue.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте Git remote, вход в GitHub и права на целевую ветку. Если результат не соответствует описанию «Создаётся PR с итогом, тестами и связанной Issue.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/pr

Что использовать дальше

/godd-a/review/godd-a/deploy
/godd-a/deploy/godd-a-deployВыполняет развёртывание с проверкой и планом отката.
Что делает
Выполняет развёртывание с проверкой и планом отката.
Когда использовать
Используйте для выпуска одобренного изменения в staging или production.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте окружение, права и одобрение развёртывания, а также шаги восстановления.
Ожидаемый результат
Показываются среда, проверки и шаги восстановления.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте окружение, права и одобрение развёртывания, а также шаги восстановления. Если результат не соответствует описанию «Показываются среда, проверки и шаги восстановления.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/deploy production

Что использовать дальше

/godd-a/release
/godd-a/release/godd-a-releaseСоздаёт release notes по истории изменений и SemVer.
Что делает
Создаёт release notes по истории изменений и SemVer.
Когда использовать
Используйте для объявления новой версии.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте Git remote, вход в GitHub и права на целевую ветку.
Ожидаемый результат
Собираются изменения для пользователей, замечания и шаги обновления.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте Git remote, вход в GitHub и права на целевую ветку. Если результат не соответствует описанию «Собираются изменения для пользователей, замечания и шаги обновления.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/release 1.4.0

Что использовать дальше

/godd-a/deploy
/godd-a/github/godd-a-githubПомогает проверить и настроить репозиторий и защиту веток.
Что делает
Помогает проверить и настроить репозиторий и защиту веток.
Когда использовать
Используйте при подготовке репозитория и правил review.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Проверьте Git remote, вход в GitHub и права на целевую ветку.
Ожидаемый результат
Показываются нужные настройки и результат применения.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Проверьте Git remote, вход в GitHub и права на целевую ветку. Если результат не соответствует описанию «Показываются нужные настройки и результат применения.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/github Настрой защиту ветки main

Что использовать дальше

/godd-a/pr/godd-a/ship

Документация и дизайн

/godd-a/docs/godd-a-docsСоздаёт или обновляет пользовательскую документацию по изменению кода.
Что делает
Создаёт или обновляет пользовательскую документацию по изменению кода.
Когда использовать
Используйте при изменении настройки, работы, конфигурации или UI.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните аудиторию, обновляемые документы и место результата.
Ожидаемый результат
Нужное руководство обновляется и сверяется с реализацией.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните аудиторию, обновляемые документы и место результата. Если результат не соответствует описанию «Нужное руководство обновляется и сверяется с реализацией.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/docs Обнови установку для текущего CLI

Что использовать дальше

/godd-a/dev/godd-a/slide
/godd-a/adr/godd-a-adrЗаписывает важное техническое решение в ADR.
Что делает
Записывает важное техническое решение в ADR.
Когда использовать
Используйте при выборе долгосрочного подхода из нескольких вариантов.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните предмет решения, ограничения и сравниваемые варианты.
Ожидаемый результат
ADR фиксирует контекст, варианты, решение и последствия.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните предмет решения, ограничения и сравниваемые варианты. Если результат не соответствует описанию «ADR фиксирует контекст, варианты, решение и последствия.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/adr Использовать PostgreSQL для audit log

Что использовать дальше

/godd-a/diagram/godd-a/docs
/godd-a/map/godd-a-mapСоздаёт Mermaid-граф архитектуры и зависимостей.
Что делает
Создаёт Mermaid-граф архитектуры и зависимостей.
Когда использовать
Используйте для знакомства с кодом или подготовки большого изменения.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Обновляется схема компонентов и направлений зависимостей.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Обновляется схема компонентов и направлений зависимостей.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/map

Что использовать дальше

/godd-a/impact/godd-a/diagram
/godd-a/diagram/godd-a-diagramОбновляет Mermaid-схемы архитектуры по текущему коду.
Что делает
Обновляет Mermaid-схемы архитектуры по текущему коду.
Когда использовать
Используйте при изменении зависимостей, состояний или взаимодействий.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните аудиторию, обновляемые документы и место результата.
Ожидаемый результат
Показываются синхронизированная схема и изменения.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните аудиторию, обновляемые документы и место результата. Если результат не соответствует описанию «Показываются синхронизированная схема и изменения.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/diagram

Что использовать дальше

/godd-a/map/godd-a/docs
/godd-a/slide/godd-a-slideСоздаёт Marp-презентацию из документов проекта.
Что делает
Создаёт Marp-презентацию из документов проекта.
Когда использовать
Используйте для review или объяснения дизайна и прогресса.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните аудиторию, обновляемые документы и место результата.
Ожидаемый результат
Создаются готовые слайды и список проверок.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните аудиторию, обновляемые документы и место результата. Если результат не соответствует описанию «Создаются готовые слайды и список проверок.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/slide docs/product-overview.md

Что использовать дальше

/godd-a/docs
/godd-a/design/godd-a-designСоздаёт или обновляет дизайн экранов по кодовой базе.
Что делает
Создаёт или обновляет дизайн экранов по кодовой базе.
Когда использовать
Используйте до UI-реализации или для синхронизации существующего экрана.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Подготовьте тестовое окружение, учётную запись и ожидаемый сценарий экранов.
Ожидаемый результат
Показываются целевой дизайн и замечания к реализации.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Подготовьте тестовое окружение, учётную запись и ожидаемый сценарий экранов. Если результат не соответствует описанию «Показываются целевой дизайн и замечания к реализации.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/design dashboard

Что использовать дальше

/godd-a/e2e/godd-a/dev
/godd-a/retro/godd-a-retroЗаписывает историю реализации за период в виде retro-отчёта.
Что делает
Записывает историю реализации за период в виде retro-отчёта.
Когда использовать
Используйте при закрытии спринта или передаче дел, когда нужен список работ за период.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните период для ретроспективы и при необходимости автора git для фильтра.
Ожидаемый результат
История реализации за период записывается в gitignore-файл Markdown внутри .godd/retro/.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните период для ретроспективы и при необходимости автора git для фильтра. Если результат не соответствует описанию «История реализации за период записывается в gitignore-файл Markdown внутри .godd/retro/.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/retro since:1w

Что использовать дальше

/godd-a/learn/godd-a/docs

Проект и операции

/godd-a/runЗапускает команду GoDD, переданную текстом.
Что делает
Запускает команду GoDD, переданную текстом.
Когда использовать
Используйте, если клиент не поддерживает нативные slash-команды.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Выбирается публичная команда и запускается её процесс.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Выбирается публичная команда и запускается её процесс.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/run /godd-a/check

Что использовать дальше

/godd-a/dev
/godd-a/setup/godd-a-setupОпределяет стек и помогает воспроизводимо настроить окружение.
Что делает
Определяет стек и помогает воспроизводимо настроить окружение.
Когда использовать
Используйте при подключении к репозиторию или запуске нового проекта.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Выявляются пробелы и создаются инструкции настройки.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Выявляются пробелы и создаются инструкции настройки.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/setup Подготовь TypeScript и React проект

Что использовать дальше

/godd-a/config/godd-a/dev
/godd-a/impact/godd-a-impactНаходит ссылки и область влияния предполагаемого изменения.
Что делает
Находит ссылки и область влияния предполагаемого изменения.
Когда использовать
Используйте перед изменением общих функций, типов или настроек.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Перечисляются затронутые вызовы, тесты, документы и вопросы.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Перечисляются затронутые вызовы, тесты, документы и вопросы.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/impact src/auth/session.ts

Что использовать дальше

/godd-a/dev/godd-a/map
/godd-a/config/godd-a-configОпределяет стек и создаёт или исправляет config.godd.
Что делает
Определяет стек и создаёт или исправляет config.godd.
Когда использовать
Используйте после init при отсутствии или ошибке конфигурации.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Показываются проверенные настройки и оставшиеся вопросы.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Показываются проверенные настройки и оставшиеся вопросы.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/config

Что использовать дальше

/godd-a/setup/godd-a/dev
/godd-a/questions/godd-a-questionsИнтерактивно закрывает список нерешённых вопросов.
Что делает
Интерактивно закрывает список нерешённых вопросов.
Когда использовать
Используйте до реализации для уточнения требований и выбора.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Ответы и открытые вопросы показываются отдельно.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Ответы и открытые вопросы показываются отдельно.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/questions

Что использовать дальше

/godd-a/dev
/godd-a/e2e/godd-a-e2eПроверяет ключевые пользовательские сценарии в браузере.
Что делает
Проверяет ключевые пользовательские сценарии в браузере.
Когда использовать
Используйте для переходов и процессов через несколько экранов.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Подготовьте тестовое окружение, учётную запись и ожидаемый сценарий экранов.
Ожидаемый результат
Показываются шаги, расхождения и доказательства воспроизведения.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Подготовьте тестовое окружение, учётную запись и ожидаемый сценарий экранов. Если результат не соответствует описанию «Показываются шаги, расхождения и доказательства воспроизведения.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/e2e Проверь завершение покупки

Что использовать дальше

/godd-a/test/godd-a/check
/godd-a/learn/godd-a-learnСохраняет и находит правила, шаблоны и риски проекта.
Что делает
Сохраняет и находит правила, шаблоны и риски проекта.
Когда использовать
Используйте, чтобы сохранить повторяемое решение или предупреждение.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Сохраняется краткая запись для повторного использования.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Сохраняется краткая запись для повторного использования.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/learn Сохрани правила именования API

Что использовать дальше

/godd-a/dev/godd-a/scratchpad
/godd-a/scratchpad/godd-a-scratchpadСохраняет, ищет и возвращает рабочие заметки между диалогами.
Что делает
Сохраняет, ищет и возвращает рабочие заметки между диалогами.
Когда использовать
Используйте для временного контекста следующей сессии.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните целевые файлы, требуемое изменение и критерии завершения.
Ожидаемый результат
Возвращается результат сохранения или найденные заметки.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните целевые файлы, требуемое изменение и критерии завершения. Если результат не соответствует описанию «Возвращается результат сохранения или найденные заметки.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/scratchpad save "Checkout проверен в staging"

Что использовать дальше

/godd-a/learn/godd-a/dev
/godd-a/metrics/godd-a-metricsПоказывает эффективность токенов и доступные доказательные метрики.
Что делает
Показывает эффективность токенов и доступные доказательные метрики.
Когда использовать
Используйте для решений по улучшению процесса на основе измерений.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните объект сравнения, условия измерения и доступные результаты проверок.
Ожидаемый результат
Только проверяемые метрики выводятся вместе с данными выборки.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните объект сравнения, условия измерения и доступные результаты проверок. Если результат не соответствует описанию «Только проверяемые метрики выводятся вместе с данными выборки.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/metrics

Что использовать дальше

/godd-a/check/godd-a/plan
/godd-a/plan/godd-a-planВыполняет утверждённый план последовательными возобновляемыми задачами.
Что делает
Выполняет утверждённый план последовательными возобновляемыми задачами.
Когда использовать
Используйте для нескольких задач с сохранением состояния и сроков.
Условия
Установите GoDD MCP α и выполните godd-a init в целевом репозитории. Уточните предмет решения, ограничения и сравниваемые варианты.
Ожидаемый результат
Возвращаются одна следующая задача и текущее состояние плана.
Если не работает
Если команда не распознана, выполните godd-a version, перезапустите MCP-клиент и повторите попытку. Уточните предмет решения, ограничения и сравниваемые варианты. Если результат не соответствует описанию «Возвращаются одна следующая задача и текущее состояние плана.», явно укажите цель и права и повторите команду.

Готовый пример

/godd-a/plan start docs/approved-plan.md

Что использовать дальше

/godd-a/dev/godd-a/check

Работа в клиенте и управление

Обычные запросы отправляйте в чате; установку и обновления выполняйте в терминале.

Запрос из чата

Обычно текст задачи указывается после /godd-a/<функция>. Если прямой вызов недоступен, используйте run.

/godd-a/dev Добавь редактирование профиля
/godd-a/run /godd-a/check

Справочник публичного CLI

godd-a install [--license-key=KEY] [--client=<id|all>]Находит поддерживаемые клиенты и регистрирует GoDD MCP α.
Что делает
Находит поддерживаемые клиенты и регистрирует GoDD MCP α.
Когда использовать
Используйте при первой установке, добавлении клиента или ремонте подключения.
Условия
Нужны Node.js 22+, ключ лицензии и поддерживаемый клиент.
Ожидаемый результат
Показываются найденные клиенты и результаты регистрации.
Если не работает
Если клиент не найден, один раз запустите его для создания папки настроек, затем повторите команду с именем клиента из списка поддерживаемых.

Готовый пример

godd-a install --license-key=YOUR_LICENSE_KEY

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a version
godd-a init [--force] [--lang=LANG] [--auto]Создаёт config.godd и необходимые файлы проекта.
Что делает
Создаёт config.godd и необходимые файлы проекта.
Когда использовать
Используйте при первом подключении репозитория или восстановлении настроек.
Условия
Выполните godd-a install и откройте корень репозитория.
Ожидаемый результат
Показываются найденный стек и созданные или обновлённые файлы.
Если не работает
Если файлы созданы не там, перейдите в корень репозитория, проверьте настройку каталога документации в config.godd и повторите команду.

Готовый пример

godd-a init --lang=ru

Что использовать дальше

godd-a install [--license-key=KEY] [--client=<id|all>]godd-a skills [candidates|promote <name>|demote <name>]
godd-a uninstall [--client=<id|all>]Удаляет регистрацию GoDD и управляемые команды из выбранных клиентов.
Что делает
Удаляет регистрацию GoDD и управляемые команды из выбранных клиентов.
Когда использовать
Используйте при отказе от клиента или сбросе регистрации.
Условия
Проверьте ID удаляемого клиента.
Ожидаемый результат
Показывается удаление только управляемых GoDD настроек.
Если не работает
Если цель не найдена, проверьте ID клиента. Если удалённая запись ещё видна, перезапустите клиент, чтобы он перечитал настройки.

Готовый пример

godd-a uninstall --client=cursor

Что использовать дальше

godd-a install [--license-key=KEY] [--client=<id|all>]godd-a version
godd-a serveЗапускает MCP stdio server.
Что делает
Запускает MCP stdio server.
Когда использовать
Обычно запускается клиентом автоматически; вручную нужен для диагностики.
Условия
Зарегистрируйте клиент через godd-a install.
Ожидаемый результат
Сервер ожидает сообщения клиента через stdin/stdout.
Если не работает
Если сервер сразу завершается, проверьте команду запуска и переменные среды клиента, затем выполните ту же команду в терминале и изучите stderr.

Готовый пример

godd-a serve

Что использовать дальше

godd-a install [--license-key=KEY] [--client=<id|all>]godd-a version
godd-a compatibilityПоказывает совместимость сжатия для каждого клиента.
Что делает
Показывает совместимость сжатия для каждого клиента.
Когда использовать
Используйте при выборе клиента или включении сжатия.
Условия
Установите GoDD MCP α.
Ожидаемый результат
Таблица показывает OS, shell, способ использования и действия при недоступности.
Если не работает
Если клиента нет в таблице, не включайте сжатие и проверьте, что показанные OS и shell совпадают с используемой средой.

Готовый пример

godd-a compatibility

Что использовать дальше

godd-a install [--license-key=KEY] [--client=<id|all>]godd-a version
godd-a codec-capability verify --npm-version <version> --manifest <path> --artifact <path> --runner <path>Проверяет manifest, artifact, runner и известные ответы codec.
Что делает
Проверяет manifest, artifact, runner и известные ответы codec.
Когда использовать
Используйте при проверке целостности релиза.
Условия
Подготовьте четыре файла и npm-версию.
Ожидаемый результат
Возвращается успешный результат или безопасная причина ошибки.
Если не работает
При ошибке проверки возьмите manifest, artifact, runner и известные ответы из одного дистрибутива и повторите без отсутствующих или изменённых файлов.

Готовый пример

godd-a codec-capability verify --npm-version 2.0.1 --manifest manifest.json --artifact codec.bin --runner codec-runner

Что использовать дальше

godd-a versiongodd-a compatibility
godd-a impact evidence cobol --root <path> [--source-format fixed|free|variable]Ограниченно извлекает связи COBOL COPY, CALL и EXEC.
Что делает
Ограниченно извлекает связи COBOL COPY, CALL и EXEC.
Когда использовать
Используйте для доказательного анализа влияния COBOL.
Условия
Укажите локальный root COBOL и при необходимости формат.
Ожидаемый результат
JSON разделяет подтверждённые, unresolved и inconclusive связи.
Если не работает
Если root или copybook не читается, укажите путь внутри репозитория и проверьте формат исходника. Неразрешённые CALL и COPY оставьте для дополнительной проверки.

Готовый пример

godd-a impact evidence cobol --root src/cobol --source-format fixed

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a version
godd-a dataset coverage --ledger <path>Проверяет результаты из stdin и сохраняет прогресс в файл.
Что делает
Проверяет результаты из stdin и сохраняет прогресс в файл.
Когда использовать
Используйте для учёта обработанных и пропущенных частей dataset.
Условия
Создайте родительскую папку и сохраните показанный ниже JSON в файл.
Ожидаемый результат
Только проверенные samples записываются, результат возвращается в JSON.
Если не работает
Если вход отклонён, перенесите generation и digests из предыдущего результата в следующий JSON и проверьте, что sample выдан, а attempt не истёк.

Готовый пример

godd-a dataset coverage --ledger .godd/dataset-coverage.json

Входной JSON (сохраните в файл)

{
  "action": "initialize",
  "generation": { "source_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "split": "eval", "epoch": 1 },
  "assigned_sample_ids": ["private-video"],
  "expected_sample_ids": ["private-video"],
  "retry_policy": {
    "max_attempts": { "DecodeError": 1, "AnnotationMissing": 1, "FrameExtraction": 1, "SourceUnavailable": 1, "ResourceExhausted": 1, "AttemptTimeout": 1 },
    "backoff": { "max_backoff_ms": 0 },
    "attempt_timeout_ms": 600000,
    "run_wall_time_budget_ms": 3600000,
    "infrastructure_failure_storm_threshold": 2
  },
  "thresholds": { "min_coverage_ratio": 1.0, "max_class_failure_ratio": 0.1, "max_split_accepted_ratio_variance": 0.0, "max_replacement_ratio": 0.0 },
  "declared_threshold_digest": "343eb2b12236e6984358603780f16fd03c23a07ccd199f04d6a404ebbd350142",
  "declared_expected_sample_id_digest": "1b442df4911573935107a07e6cda5dafccc5832c09d7a8d38b6475be6ef47fc3",
  "replacement_policy": "forbidden"
}

PowerShell

Get-Content -Raw dataset-action.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

cat dataset-action.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Как использовать каждое действие

initialize

Что делает
initialize используется для результата: «учёт начинается с одного ожидаемого элемента».
Условия
Требуется: показанный JSON и существующая папка .godd.
Ожидаемый результат
Результат: учёт начинается с одного ожидаемого элемента.
Если не работает
При ошибке: скопируйте все поля и используйте новый файл.
{
  "action": "initialize",
  "generation": { "source_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "split": "eval", "epoch": 1 },
  "assigned_sample_ids": ["private-video"],
  "expected_sample_ids": ["private-video"],
  "retry_policy": {
    "max_attempts": { "DecodeError": 1, "AnnotationMissing": 1, "FrameExtraction": 1, "SourceUnavailable": 1, "ResourceExhausted": 1, "AttemptTimeout": 1 },
    "backoff": { "max_backoff_ms": 0 },
    "attempt_timeout_ms": 600000,
    "run_wall_time_budget_ms": 3600000,
    "infrastructure_failure_storm_threshold": 2
  },
  "thresholds": { "min_coverage_ratio": 1.0, "max_class_failure_ratio": 0.1, "max_split_accepted_ratio_variance": 0.0, "max_replacement_ratio": 0.0 },
  "declared_threshold_digest": "343eb2b12236e6984358603780f16fd03c23a07ccd199f04d6a404ebbd350142",
  "declared_expected_sample_id_digest": "1b442df4911573935107a07e6cda5dafccc5832c09d7a8d38b6475be6ef47fc3",
  "replacement_policy": "forbidden"
}

PowerShell

Get-Content -Raw dataset-initialize.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

cat dataset-initialize.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

issue

Что делает
issue используется для результата: «возвращаются попытка 1 и срок».
Условия
Требуется: инициализированный файл и dataset-issue.json.
Ожидаемый результат
Результат: возвращаются попытка 1 и срок.
Если не работает
При ошибке: сначала выполните initialize и используйте тот же sample id.
{"action":"issue","canonical_sample_id":"private-video","requested_position":0}

PowerShell

Get-Content -Raw dataset-issue.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

cat dataset-issue.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

report

Что делает
report используется для результата: «успешный элемент записывается».
Условия
Требуется: номер попытки из issue и dataset-report.json.
Ожидаемый результат
Результат: успешный элемент записывается.
Если не работает
При ошибке: используйте номер из issue до окончания срока.
{"action":"report","canonical_sample_id":"private-video","attempt":1,"outcome":"Accepted"}

PowerShell

Get-Content -Raw dataset-report.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

cat dataset-report.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

sweep

Что делает
sweep используется для результата: «просроченные попытки подсчитываются и очищаются».
Условия
Требуется: инициализированный файл прогресса.
Ожидаемый результат
Результат: просроченные попытки подсчитываются и очищаются.
Если не работает
При ошибке: проверьте путь и написание JSON.
{"action":"sweep"}

PowerShell

'{"action":"sweep"}' | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

printf '%s' '{"action":"sweep"}' | godd-a dataset coverage --ledger .godd/dataset-coverage.json

finalize

Что делает
finalize используется для результата: «возвращается итоговый результат покрытия».
Условия
Требуется: report для всех элементов и dataset-finalize.json.
Ожидаемый результат
Результат: возвращается итоговый результат покрытия.
Если не работает
При ошибке: используйте те же пороги и digest, что в initialize.
{"action":"finalize","thresholds":{"min_coverage_ratio":1.0,"max_class_failure_ratio":0.1,"max_split_accepted_ratio_variance":0.0,"max_replacement_ratio":0.0},"replacement_policy":"forbidden","declared_threshold_digest":"343eb2b12236e6984358603780f16fd03c23a07ccd199f04d6a404ebbd350142","declared_expected_sample_id_digest":"1b442df4911573935107a07e6cda5dafccc5832c09d7a8d38b6475be6ef47fc3"}

PowerShell

Get-Content -Raw dataset-finalize.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Bash / zsh

cat dataset-finalize.json | godd-a dataset coverage --ledger .godd/dataset-coverage.json

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a operate [--session=<id>] [--timeout-ms=<ms>] -- <program> [args...]
godd-a gateway doctor [--no-probe]Проверяет настройку подключения и наличие ответа.
Что делает
Проверяет настройку подключения и наличие ответа.
Когда использовать
Используйте при включении подключения или поиске причины его недоступности.
Условия
При использовании gateway задайте GODD_PROVIDER_GATEWAY_URL.
Ожидаемый результат
Показывается отчёт без секретных данных.
Если не работает
Если подключения нет, проверьте, что GODD_PROVIDER_GATEWAY_URL указывает на правильный HTTPS endpoint, затем проверьте его работу и доступность сети.

Готовый пример

godd-a gateway doctor

Что использовать дальше

godd-a versiongodd-a compatibility
godd-a plan audit <record|verify> [...]Записывает или проверяет прерывание, продолжение и отклонение плана.
Что делает
Записывает или проверяет прерывание, продолжение и отклонение плана.
Когда использовать
Используйте после прерывания, продолжения или отклонения от approved plan.
Условия
Нужны активный approved plan и GODD_LICENSE_KEY.
Ожидаемый результат
Возвращается результат проверки записей или безопасная причина ошибки.
Если не работает
Если проверка не проходит, убедитесь, что используются те же run ID и лицензия. После смены лицензии продолжайте работу с новым run ID.

Готовый пример

godd-a plan audit verify

Как использовать каждое действие

record

Что делает
record используется для результата: «причина остановки записывается».
Условия
Требуется: активный одобренный план и лицензионный ключ.
Ожидаемый результат
Результат: причина остановки записывается.
Если не работает
При ошибке: проверьте активный план и значение --event: interrupted, resumed или plan-deviation.
godd-a plan audit record --event interrupted --reason-code user_pause --expected-step test --actual-step test

verify

Что делает
verify используется для результата: «сохранённые записи проверяются».
Условия
Требуется: тот же проект и лицензия, что при записи.
Ожидаемый результат
Результат: сохранённые записи проверяются.
Если не работает
При ошибке: проверьте, что активный план и лицензия не изменились.
godd-a plan audit verify

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a version
godd-a research <start|checkpoint|status|complete|abort> [options]Хранит минимальные checkpoints возобновляемого исследования.
Что делает
Хранит минимальные checkpoints возобновляемого исследования.
Когда использовать
Используйте для исследования через несколько сессий.
Условия
Подготовьте безопасное резюме и публичные HTTPS sources.
Ожидаемый результат
Состояние возвращается в JSON без сырого текста и секретов.
Если не работает
Если session не найдена, передайте точный ID в status. Если сохранение отклонено, удалите секреты из summary и оставьте только публичные HTTPS URL.

Готовый пример

godd-a research start --session research-1 --topic "API retry policy"

Как использовать каждое действие

start

Что делает
start используется для результата: «создаётся новая сессия исследования».
Условия
Требуется: уникальное имя сессии и тема без секретных данных.
Ожидаемый результат
Результат: создаётся новая сессия исследования.
Если не работает
При ошибке: выберите имя, которое ещё не используется.
godd-a research start --session research-1 --topic "API retry policy"

checkpoint

Что делает
checkpoint используется для результата: «промежуточный результат сохраняется».
Условия
Требуется: активная сессия, краткое резюме и при необходимости публичный HTTPS URL.
Ожидаемый результат
Результат: промежуточный результат сохраняется.
Если не работает
При ошибке: удалите закрытый текст и используйте публичный HTTPS URL без query.
godd-a research checkpoint --session research-1 --summary "Retry rules confirmed" --source https://example.com/retry

status

Что делает
status используется для результата: «показываются текущее резюме и состояние».
Условия
Требуется: имя существующей сессии.
Ожидаемый результат
Результат: показываются текущее резюме и состояние.
Если не работает
При ошибке: проверьте имя, возвращённое командой start.
godd-a research status --session research-1

complete

Что делает
complete используется для результата: «сессия отмечается завершённой».
Условия
Требуется: активная сессия с завершённым исследованием.
Ожидаемый результат
Результат: сессия отмечается завершённой.
Если не работает
При ошибке: сначала сохраните итог через checkpoint.
godd-a research complete --session research-1

abort

Что делает
abort используется для результата: «сессия отмечается прерванной».
Условия
Требуется: активная сессия и причина без секретных данных.
Ожидаемый результат
Результат: сессия отмечается прерванной.
Если не работает
При ошибке: укажите и --session, и --reason.
godd-a research abort --session research-1 --reason superseded

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a operate [--session=<id>] [--timeout-ms=<ms>] -- <program> [args...]
godd-a operate [--session=<id>] [--timeout-ms=<ms>] -- <program> [args...]Запускает выбранную программу с состоянием и timeout.
Что делает
Запускает выбранную программу с состоянием и timeout.
Когда использовать
Используйте для внешнего агента с JSON/NDJSON output.
Условия
Проверьте программу и её контракт JSON/NDJSON.
Ожидаемый результат
JSON содержит только turn, состояние и exit code.
Если не работает
Если дочерняя программа завершается ошибкой, отдельно проверьте JSON/NDJSON с переводом строки в stdout; для долгой штатной работы увеличьте timeout.

Готовый пример

godd-a operate --timeout-ms=30000 -- node worker.mjs

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a research <start|checkpoint|status|complete|abort> [options]
godd-a shard partition <plan|lease|report|expire|abandon|status> [options]Делит работу и управляет резервированием, результатами, сроками и состоянием.
Что делает
Делит работу и управляет резервированием, результатами, сроками и состоянием.
Когда использовать
Используйте для разделения большой работы без двойного владения.
Условия
Проверьте state directory существующего shard plan. Для создания plan также нужны source root и selector N/M.
Ожидаемый результат
Текущее состояние shards и leases возвращается в JSON.
Если не работает
Если lease или report отклонён, получите свежий status и заново соберите вход с его generation, revision, назначенным shard и текущими значениями lease.

Готовый пример

godd-a shard partition status --state-dir .godd/shard-state

Как использовать каждое действие

plan

Что делает
plan используется для результата: «создаётся план из двух частей».
Условия
Требуется: существующая папка данных и новая папка состояния.
Ожидаемый результат
Результат: создаётся план из двух частей.
Если не работает
При ошибке: проверьте формат N/M и расположение данных внутри проекта.
godd-a shard partition plan --state-dir .godd/shards --source-root data --selector 1/2

lease

Что делает
lease используется для результата: «первая часть резервируется на 60 секунд и сохраняется для report».
Условия
Требуется: созданный план и свободная часть.
Ожидаемый результат
Результат: первая часть резервируется на 60 секунд и сохраняется для report.
Если не работает
При ошибке: проверьте status и дождитесь окончания либо явно перехватите просроченную бронь.
godd-a shard partition lease --state-dir .godd/shards --selector 1/2 --ttl-ms 60000

PowerShell

godd-a shard partition lease --state-dir .godd/shards --selector 1/2 --ttl-ms 60000 | Set-Content -Encoding utf8NoBOM shard-lease.json

Bash / zsh

godd-a shard partition lease --state-dir .godd/shards --selector 1/2 --ttl-ms 60000 > shard-lease.json

report

Что делает
report используется для результата: «завершённый элемент записывается».
Условия
Требуется: shard-lease.json с последним выводом lease.
Ожидаемый результат
Результат: завершённый элемент записывается.
Если не работает
При ошибке: сохраните свежий вывод lease и повторите до окончания срока.
{"plan_generation":{"source_generation":"<plan output>","expected_set_digest":"<plan output>"},"sequence_id":"<lease assigned_ids[0]>","reporting_shard_index":1,"lease_generation":1,"expected_state":"assigned","expected_ledger_revision":0,"outcome":"completed"}

PowerShell

node -e "const l=require('./shard-lease.json');process.stdout.write(JSON.stringify({plan_generation:l.plan_generation,sequence_id:l.assigned_ids[0],reporting_shard_index:l.shard_index,lease_generation:l.lease_generation,expected_state:'assigned',expected_ledger_revision:l.ledger_revision,outcome:'completed'}))" | godd-a shard partition report --state-dir .godd/shards

Bash / zsh

node -e "const l=require('./shard-lease.json');process.stdout.write(JSON.stringify({plan_generation:l.plan_generation,sequence_id:l.assigned_ids[0],reporting_shard_index:l.shard_index,lease_generation:l.lease_generation,expected_state:'assigned',expected_ledger_revision:l.ledger_revision,outcome:'completed'}))" | godd-a shard partition report --state-dir .godd/shards

expire

Что делает
expire используется для результата: «просроченные брони освобождаются».
Условия
Требуется: существующий план.
Ожидаемый результат
Результат: просроченные брони освобождаются.
Если не работает
При ошибке: проверьте папку и повторите после срока брони.
godd-a shard partition expire --state-dir .godd/shards

abandon

Что делает
abandon используется для результата: «бронь становится доступной для нового назначения».
Условия
Требуется: бронь выбранной части.
Ожидаемый результат
Результат: бронь становится доступной для нового назначения.
Если не работает
При ошибке: используйте тот же selector, что при lease.
godd-a shard partition abandon --state-dir .godd/shards --selector 1/2

status

Что делает
status используется для результата: «показываются прогресс и оставшиеся элементы».
Условия
Требуется: существующий план.
Ожидаемый результат
Результат: показываются прогресс и оставшиеся элементы.
Если не работает
При ошибке: сначала создайте plan или исправьте папку.
godd-a shard partition status --state-dir .godd/shards

Что использовать дальше

godd-a operate [--session=<id>] [--timeout-ms=<ms>] -- <program> [args...]godd-a version
godd-a realtime <admission|admission-dev> --evaluated-at-ms <u64>Решает, можно ли запускать обработку в реальном времени на указанное время.
Что делает
Решает, можно ли запускать обработку в реальном времени на указанное время.
Когда использовать
Используйте прямо перед production или development realtime worker.
Условия
Передайте показанный ниже JSON события через stdin и укажите текущее время Unix в миллисекундах.
Ожидаемый результат
Команда сообщает, можно ли начать обработку, а при отказе объясняет причину.
Если не работает
Если запуск запрещён, изучите причину, создайте requested_at и evaluated-at-ms из одного текущего времени и обновите deadline и generation evidence.

Готовый пример

godd-a realtime admission --evaluated-at-ms ([DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds())

PowerShell

$nowMs = [DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds(); node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" $nowMs | godd-a realtime admission --evaluated-at-ms $nowMs

Bash / zsh

now_ms="$(node -p Date.now())"; node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" "$now_ms" | godd-a realtime admission --evaluated-at-ms "$now_ms"

Как использовать каждое действие

admission

Что делает
admission используется для результата: «возвращается разрешение или ясная причина отказа».
Условия
Требуется: JSON события и время оценки из одного текущего времени.
Ожидаемый результат
Результат: возвращается разрешение или ясная причина отказа.
Если не работает
При ошибке: создайте requested_at и время оценки из одного значения и проверьте fingerprint.
godd-a realtime admission --evaluated-at-ms $nowMs

PowerShell

$nowMs = [DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds(); node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" $nowMs | godd-a realtime admission --evaluated-at-ms $nowMs

Bash / zsh

now_ms="$(node -p Date.now())"; node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" "$now_ms" | godd-a realtime admission --evaluated-at-ms "$now_ms"

admission-dev

Что делает
admission-dev используется для результата: «режим разработки возвращает то же решение».
Условия
Требуется: JSON события и текущее время в среде разработки.
Ожидаемый результат
Результат: режим разработки возвращает то же решение.
Если не работает
При ошибке: исправьте созданное событие до запуска development worker.
godd-a realtime admission-dev --evaluated-at-ms $nowMs

PowerShell

$nowMs = [DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds(); node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" $nowMs | godd-a realtime admission-dev --evaluated-at-ms $nowMs

Bash / zsh

now_ms="$(node -p Date.now())"; node -e "const n=Number(process.argv[1]);const h='a'.repeat(64);const requested=new Date(Math.floor(n/1000)*1000).toISOString().replace('.000Z','Z');process.stdout.write(JSON.stringify({schema_version:1,principal_fingerprint:'principal:sha256:'+h,resource_id:'resource:sha256:'+h,resource_generation:7,action:'player:join',evidence:[{kind:'membership',generation:7,outcome:'present',evidence_fingerprint:'evidence:sha256:'+h}],policy_generation:3,requested_at:requested,deadline_ms:60000}))" "$now_ms" | godd-a realtime admission-dev --evaluated-at-ms "$now_ms"

Что использовать дальше

godd-a operate [--session=<id>] [--timeout-ms=<ms>] -- <program> [args...]godd-a version
godd-a versionПоказывает установленную версию и проверяет обновления.
Что делает
Показывает установленную версию и проверяет обновления.
Когда использовать
Используйте при диагностике, перед обновлением или обращением в поддержку.
Условия
Сначала установите GoDD MCP α глобально.
Ожидаемый результат
Показываются текущая и, если доступна сеть, последняя версии.
Если не работает
Если последнюю версию получить не удалось, проверьте сеть и proxy. Показанную установленную версию всё равно можно использовать как сведения о среде.

Готовый пример

godd-a version

Что использовать дальше

godd-a install [--license-key=KEY] [--client=<id|all>]godd-a compatibility
godd-a skills [candidates|promote <name>|demote <name>]Показывает кандидатов и повышает или понижает знания проекта.
Что делает
Показывает кандидатов и повышает или понижает знания проекта.
Когда использовать
Используйте для управления повторно используемыми знаниями.
Условия
Выполните godd-a init в проекте.
Ожидаемый результат
Возвращаются кандидаты или результат promote/demote.
Если не работает
Если candidate или skill не найден, запустите команду из корня проекта, скопируйте точное имя из candidates и повторите promote или demote.

Готовый пример

godd-a skills candidates

Как использовать каждое действие

candidates

Что делает
candidates используется для результата: «показываются доступные и заблокированные кандидаты».
Условия
Требуется: проект с персональными skills.
Ожидаемый результат
Результат: показываются доступные и заблокированные кандидаты.
Если не работает
При ошибке: запустите из корня проекта.
godd-a skills candidates

promote

Что делает
promote используется для результата: «skill становится доступен всему проекту».
Условия
Требуется: имя доступного персонального skill из candidates.
Ожидаемый результат
Результат: skill становится доступен всему проекту.
Если не работает
При ошибке: устраните все причины BLOCKED.
godd-a skills promote api-review

demote

Что делает
demote используется для результата: «skill возвращается в персональную область».
Условия
Требуется: проектный skill, который можно вернуть в персональную область.
Ожидаемый результат
Результат: skill возвращается в персональную область.
Если не работает
При ошибке: проверьте точное имя и текущую область.
godd-a skills demote api-review

Что использовать дальше

godd-a init [--force] [--lang=LANG] [--auto]godd-a version

Решение проблем

Сначала проверьте установку и перезапустите клиент.

Команда не найдена

Выполните godd-a version, при необходимости повторите godd-a install и перезапустите MCP-клиент.

godd-a version

Отдельный ключ аудита не нужен

Обычно plan audit работает с текущим лицензионным ключом. Дополнительная настройка ключа не требуется.

Лицензия и поддержка

Тарифы, выпуск лицензии и доступная поддержка описаны на странице цен.