AGENT SKILL

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.

Процедура

  1. Взять за образец diagrams/calm/example.calm.json, не копируя чужие данные клиента.
  2. Проверить, что каждый source и destination существует как unique-id.
  3. Запустить python3 cli/mazu.py check calm путь/к/файлу.json.
  4. Исправить CALM-2 и CALM-3. Неизвестный тип связи и висячий конец — ошибки.
  5. Если связь изменилась из-за решения, обновить 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