requirements
Пишет проверяемое требование и не путает его с задачей.
- License 许可
- MIT
- 最近更新
- 2026-10-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- requirements
- description
- Пишет проверяемое требование и не путает его с задачей.
03 SKILL.md 正文
Требования
Требование говорит, что система делает при условии. Задача говорит, какой шаг сделать. Требование без условия и реакции нельзя проверить, поэтому оно не готово к спецификации.
Ответственность
Владелец: PO и SDD author.
Код, который проверяет результат: src/mazu_method/bdd.py.
Если вопрос принадлежит другой роли, этот скилл останавливается и называет её. Он не закрывает чужой гейт и не подменяет чужое решение.
Когда открывать
- Есть эпик и нужно зафиксировать поведение до историй.
- Формулировка звучит как «должен быть удобным».
Когда не открывать
- Уже есть вертикальный срез и Then. Дальше это история, не ещё одно требование.
- Выбор уже дорогой. Это ADR, не REQ.
Входы, без которых процедуру не начинают
- Условие и наблюдаемая реакция.
- Родитель-эпик.
Процедура
- Переписать фразу в вид: когда происходит X, система делает Y.
- Записать:
python3 cli/mazu.py add requirement "когда X, система Y" --parent EPIC-001. - Если реакцию нельзя увидеть, остановиться. Не записывать требование-комплимент.
- Перенести проверяемые требования в спецификацию и в acceptance историй.
- Не ставить points на requirement. Points появятся на истории.
Гейты и гардрейлы
- Нет наблюдаемой реакции — запись не создают.
- Требование не проходит
gate ready: этот гейт только для story. Не пытаться им закрыть REQ.
Ненулевой код выхода — это отказ. Агент не пишет, что шаг пройден, пока в stdout нет PASS.
Делать
- Держать одно требование на одну реакцию.
- Ссылаться на эпик через parent.
Не делать
- Не писать решение внутри требования, если способ ещё не выбран.
- Не копировать требование в десять историй без нарезки.
Контроль качества
list --kind requirementпоказывает parent у каждой строки.- Каждое требование можно превратить в Then без новых догадок.
Как выглядит провал
- Реакция «работает хорошо».
- Требование без эпика, и через неделю никто не знает, чей это исход.
Передача
Набор требований забирает SDD author в спецификацию и BDD author в сценарии.
Пример команд
python3 cli/mazu.py add requirement "Когда у истории нет Then, gate ready завершается с ошибкой" --parent EPIC-001
Применение инструментов
Каждая команда выше — это python3 cli/mazu.py ... из корня набора. Схему вызова для модели берут из tools/openai.json или tools/gigachat.json и не выдумывают имя функции. Результат известен только после stdout.
Политика и контракт модели
Прочитай файл целиком до первой команды. Политика набора — standards/POLICY.md, и она сильнее этого скилла, если они спорят.
Сделай только раздел «Процедура». Разделы «Когда не открывать» и «Не делать» — запрет, не совет.
Команда с ненулевым кодом — стоп. Покажи её stdout. Не называй это частичным успехом.
Доказательство — строка PASS или id, который команда напечатала. Пока stdout нет, факта нет.
Дальше работает только роль из раздела «Передача». Не делай её шаги в этой же сессии.
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