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, потом правка файла в том же шаге.
Входы, без которых процедуру не начинают
- Имя приложения, путь эндпоинта, тип возврата.
- Уверенность, что в тексте нет паролей, ключей и боевых адресов.
Процедура
- Открыть существующий файл или создать рядом с проектом, не внутри чужого бэклога.
- Нужны блок приложения на нулевом отступе, строка эндпоинта с
/, слово return и тип через<:. - Запустить
python3 cli/mazu.py check sysl путь/к/файлу.sysl. - Исправить каждый SYSL-2. Команда не дописывает файл сама.
- Если поведение изменилось вместе с решением, в том же изменении обновить 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
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