AGENT SKILL

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.

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

  • Условие и наблюдаемая реакция.
  • Родитель-эпик.

Процедура

  1. Переписать фразу в вид: когда происходит X, система делает Y.
  2. Записать: python3 cli/mazu.py add requirement "когда X, система Y" --parent EPIC-001.
  3. Если реакцию нельзя увидеть, остановиться. Не записывать требование-комплимент.
  4. Перенести проверяемые требования в спецификацию и в acceptance историй.
  5. Не ставить 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