AGENT SKILL

sysl

Проверяет текстовую модель вызовов. Картинка не требуется и не считается источником.

License 许可
MIT
最近更新
2026-10-23
Stars
★ 0
Forks
0

01 前言 Front Matter

name
sysl
description
Проверяет текстовую модель вызовов. Картинка не требуется и не считается источником.

03 SKILL.md 正文

Sysl: поведение

Sysl отвечает, кто кого вызывает и что возвращает. Если нужны только коробки и связи, это CALM, не этот скилл. Если программы, которая рисует Sysl, нет на машине, файл всё равно оставляют и прямо говорят, что рисунок не строился.

Ответственность

Владелец: Sysl modeler. Код, который проверяет результат: src/mazu_method/sysl_check.py. Если вопрос принадлежит другой роли, этот скилл останавливается и называет её. Он не закрывает чужой гейт и не подменяет чужое решение.

Когда открывать

  • Появился или изменился вызов между частями системы.
  • Надо проверить уже лежащий пример перед сдачей набора.

Когда не открывать

  • Нужно показать, кто владеет данными на годы. Это enterprise architect и CALM.
  • Нужно решить, какой выбор дорогой. Сначала ADR, потом правка файла в том же шаге.

Входы, без которых процедуру не начинают

  • Имя приложения, путь эндпоинта, тип возврата.
  • Уверенность, что в тексте нет паролей, ключей и боевых адресов.

Процедура

  1. Открыть существующий файл или создать рядом с проектом, не внутри чужого бэклога.
  2. Нужны блок приложения на нулевом отступе, строка эндпоинта с /, слово return и тип через <:.
  3. Запустить python3 cli/mazu.py check sysl путь/к/файлу.sysl.
  4. Исправить каждый SYSL-2. Команда не дописывает файл сама.
  5. Если поведение изменилось вместе с решением, в том же изменении обновить ADR.

Гейты и гардрейлы

  • Пустой файл, нет приложения, нет эндпоинта, нет return или нет типа — FAIL.
  • Строка, похожая на пароль или ключ, — FAIL SYSL-2 secret-like text.

Ненулевой код выхода — это отказ. Агент не пишет, что шаг пройден, пока в stdout нет PASS.

Делать

  • Держать один блок на приложение или актора.
  • Проверять примеры набора: diagrams/sysl/example.sysl и diagrams/sysl/backlog.sysl.

Не делать

  • Не считать PNG источником. Источник — текст.
  • Не описывать этим файлом только состав без вызовов.
  • Не класть секрет, чтобы «пример был реалистичным».

Контроль качества

  • check sysl печатает PASS.
  • В ответе человеку сказано, строилась ли картинка. Если нет, это названо.

Как выглядит провал

  • SYSL-2 no application block.
  • SYSL-2 no endpoint.
  • SYSL-2 return has no type.

Передача

PASS по изменённому поведению вместе с ADR забирает solution architect. Состав системы этим скиллом не закрывают.

Пример команд

python3 cli/mazu.py check sysl diagrams/sysl/example.sysl
python3 cli/mazu.py check sysl diagrams/sysl/backlog.sysl

Применение инструментов

Каждая команда выше — это python3 cli/mazu.py ... из корня набора. Схему вызова для модели берут из tools/openai.json или tools/gigachat.json и не выдумывают имя функции. Результат известен только после stdout.

Политика и контракт модели

Прочитай файл целиком до первой команды. Политика набора — standards/POLICY.md, и она сильнее этого скилла, если они спорят. Сделай только раздел «Процедура». Разделы «Когда не открывать» и «Не делать» — запрет, не совет. Команда с ненулевым кодом — стоп. Покажи её stdout. Не называй это частичным успехом. Доказательство — строка PASS или id, который команда напечатала. Пока stdout нет, факта нет. Дальше работает только роль из раздела «Передача». Не делай её шаги в этой же сессии.

Боевой бинарник: bin/sysl (ELF, v0.792.0). bin/sysl validate diagrams/sysl/example.sysl должен закончиться нулём.

04 同仓库更多 Skills