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