AGENT SKILL

sdd

Пишет спецификацию, которая может отклонить лишний diff, и ставит границы Always, Ask First, Never.

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

01 前言 Front Matter

name
sdd
description
Пишет спецификацию, которая может отклонить лишний diff, и ставит границы Always, Ask First, Never.

03 SKILL.md 正文

SDD: спецификация до кода

Спецификация — якорь. Сначала что и для кого, потом план, потом задачи, потом реализация. Если требование изменилось, правят спецификацию и список историй. Тихое расширение истории — дефект процесса, а не скорость.

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

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

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

  • Есть эпик и ещё нет файла спецификации.
  • История готова к ready, но границы только в голове.
  • Кто-то просит сделать «заодно» то, чего нет в спецификации.

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

  • Нужно только записать решение о хранилище. Это ADR.
  • Нужно нарисовать состав системы. Это CALM.

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

  • Цель одной фразой и список того, что вне scope.
  • Шаблон templates/spec.md. Его копируют в mazu-data/specs/, не правят оригинал шаблона под один проект.

Процедура

  1. Скопировать шаблон в mazu-data/specs/<имя>.md и заполнить цель, акторов, вне scope, требования, приёмку, план, задачи, границы, улику.
  2. На каждую историю повесить границы флагами --always, --ask-first, --never при add или помнить, что пустые границы не пройдут gate ready.
  3. Проверить карточку: python3 cli/mazu.py check boundaries ID.
  4. Перед спорным действием спросить код: python3 cli/mazu.py check guard "add a new dependency" --ask "new dependency" --never "commit secrets".
  5. Если guard вернул BOUND-2, остановиться и спросить человека. Если BOUND-3, отказаться.

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

  • Always делают без вопроса: валидный store, проверка нового поведения, соблюдение принятого ADR.
  • Ask First останавливает: новая зависимость, смена схемы, смена публичной команды, правка вне истории, смешение трёх слоёв архитектуры.
  • Never запрещено даже ради зелёного статуса: секреты, удаление истории store, удаление проверки, бэклог клиента в репозитории метода.

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

Делать

  • Писать требование так, чтобы его можно было сверить с diff.
  • Держать Never спецификации даже если история добавила свой список. Код merge не удаляет Never.
  • Называть идентификатор BOUND, когда останавливаетесь.

Не делать

  • Не начинать реализацию при открытом Ask First.
  • Не считать «сделай как считаешь нужным» снятием Never.
  • Не превращать спецификацию в сгенерированный исходник.

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

  • В спецификации есть вне scope. Без него любая добавка выглядит нужной.
  • check boundaries для истории, которая претендует на ready, даёт PASS.

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

  • FAIL BOUND-5 boundaries are missing.
  • Выход guard с текстом BOUND-2 stop and ask.
  • Выход guard с текстом BOUND-3 refuse.

Передача

Готовая спецификация уходит BDD author на сценарии и solution architect на контракт. Реализацию не начинают.

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

python3 cli/mazu.py check guard "commit secrets in the repo" --never "commit secrets"
python3 cli/mazu.py check boundaries US-001

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

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

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

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

Spec Kit: bin/specify version (CLI 1.2.3, Python из upstream/cpython). Границы истории: check boundaries.

04 同仓库更多 Skills