calm
Проверяет JSON узлов и связей. Идентификатор узла стабилен.
- License 许可
- MIT
- 最近更新
- 2026-10-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- calm
- description
- Проверяет JSON узлов и связей. Идентификатор узла стабилен.
03 SKILL.md 正文
CALM: состав
CALM отвечает, из каких частей система состоит и кто с кем связан. Он не заменяет Sysl: в нём нет контракта вызова. Идентификатор unique-id не меняют из-за красивой подписи.
Ответственность
Владелец: CALM modeler.
Код, который проверяет результат: src/mazu_method/calm_check.py.
Если вопрос принадлежит другой роли, этот скилл останавливается и называет её. Он не закрывает чужой гейт и не подменяет чужое решение.
Когда открывать
- Появилась часть системы или связь между частями.
- Надо проверить примеры набора перед сдачей.
Когда не открывать
- Нужно описать тело ответа эндпоинта. Это Sysl.
- Нужно выбрать, делать ли связь вообще. Сначала ADR, если выбор дорогой.
Входы, без которых процедуру не начинают
- Список частей с постоянными id и типами узлов.
- Связи interacts или connects с концами, которые есть среди id.
Процедура
- Взять за образец
diagrams/calm/example.calm.json, не копируя чужие данные клиента. - Проверить, что каждый source и destination существует как unique-id.
- Запустить
python3 cli/mazu.py check calm путь/к/файлу.json. - Исправить CALM-2 и CALM-3. Неизвестный тип связи и висячий конец — ошибки.
- Если связь изменилась из-за решения, обновить ADR в том же шаге.
Гейты и гардрейлы
- Документ обязан быть JSON-объектом со списком nodes.
- Секрет в любом строковом поле — FAIL CALM-4.
- Дубль unique-id — FAIL CALM-2.
Ненулевой код выхода — это отказ. Агент не пишет, что шаг пройден, пока в stdout нет PASS.
Делать
- Хранить имя отдельно от id. Имя можно сменить, id нет.
- Проверять
diagrams/calm/example.calm.jsonиdiagrams/calm/backlog.calm.json.
Не делать
- Не записывать поведение эндпоинта в описание узла вместо Sysl.
- Не класть имя клиента и боевой адрес.
Контроль качества
check calmпечатает PASS.- Каждая новая связь упомянута в ADR, если она дорогая.
Как выглядит провал
- CALM-3 not json.
- CALM-3 destination ... is not a node.
- CALM-2 duplicate unique-id.
Передача
PASS по составу забирает enterprise architect, если вопрос про владение, или solution architect, если вопрос про контракт этого спринта.
Пример команд
python3 cli/mazu.py check calm diagrams/calm/example.calm.json
python3 cli/mazu.py check calm diagrams/calm/backlog.calm.json
Применение инструментов
Каждая команда выше — это python3 cli/mazu.py ... из корня набора. Схему вызова для модели берут из tools/openai.json или tools/gigachat.json и не выдумывают имя функции. Результат известен только после stdout.
Политика и контракт модели
Прочитай файл целиком до первой команды. Политика набора — standards/POLICY.md, и она сильнее этого скилла, если они спорят.
Сделай только раздел «Процедура». Разделы «Когда не открывать» и «Не делать» — запрет, не совет.
Команда с ненулевым кодом — стоп. Покажи её stdout. Не называй это частичным успехом.
Доказательство — строка PASS или id, который команда напечатала. Пока stdout нет, факта нет.
Дальше работает только роль из раздела «Передача». Не делай её шаги в этой же сессии.
Боевой скрипт: bin/calm validate --architecture diagrams/calm/example.calm.json --format json. Успех — hasErrors: false, версия 1.65.0.
04 同仓库更多 Skills
bmad
Provides the canonical BMad entrypoint. Use when the root BMad skill needs validation.
bmad-review-verification-gap
Deprecated — forwards to bmad-review
bmad-review-edge-case-hunter
Deprecated — forwards to bmad-review
bmad-review-adversarial-general
Deprecated — forwards to bmad-review
bmad-editorial-review
Deprecated — forwards to bmad-review
bmad-editorial-review-structure
Deprecated — forwards to bmad-review