AGENT SKILL

estimation

Отделяет сложность от уже потраченных часов и отвергает чужую шкалу.

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

01 前言 Front Matter

name
estimation
description
Отделяет сложность от уже потраченных часов и отвергает чужую шкалу.

03 SKILL.md 正文

Points и время

Story points отвечают, насколько сложно и неопределённо. Часы отвечают, сколько уже потратили. Это разные поля, разные команды и разные полосы на дашборде. Их не складывают и не переводят друг в друга.

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

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

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

  • Истории ставят оценку перед ready.
  • После работы надо записать стоимость.
  • Из Jira приехала оценка 4 или 6.

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

  • Нужно решить, готова ли история целиком. Points — только одна проверка внутри gate ready.

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

  • Сравнение с уже сделанной историей на 1, 2, 3, 5 или 8. Не с часами.
  • Фактическое время после работы, если оно известно.

Процедура

  1. Поставить points только из ряда 1, 2, 3, 5, 8, 13, 21: флаг --points у add.
  2. Если CLI отверг число, не округлять его молча до ближайшего Фибоначчи. Оставить поле пустым и сказать, что шкала чужая.
  3. 13 и 21 можно записать, но gate ready их не пропустит. Это сигнал разрезать.
  4. После работы: python3 cli/mazu.py log ID 1.5 --note "что делали".
  5. Сверить: python3 cli/mazu.py check points ID. Команда печатает оба числа и не объявляет их равными по смыслу.

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

  • Число вне ряда не попадает в store.
  • Points 13 и выше дают EPIC-2 на ready.
  • Часы обязаны быть больше нуля. Ноль и отрицательные log не примет.

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

Делать

  • Объяснять 5 как «заметно сложнее трёх», а не как «пять часов».
  • На ретро смотреть расхождение, не подгонять points задним числом под часы.

Не делать

  • Не копировать одно число в points и в hours.
  • Не считать velocity в часах.
  • Не оценивать задачу. У задачи нет points.

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

  • check points показывает пустые или допустимые points.
  • На дашборде три полосы стоят рядом и подписаны раздельно.

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

  • points must be one of (1, 2, 3, 5, 8, 13, 21).
  • EST-2 points are missing.
  • EST-2 points must be 1, 2, 3, 5, 8, 13, or 21.

Передача

Допустимые points вместе со сценарием и границами забирает gate ready. Часы остаются у разработчика до ретро.

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

python3 cli/mazu.py add story "Slice" --parent EPIC-001 --points 5 --acceptance "Given a When b Then c" --never "Commit secrets"
python3 cli/mazu.py log US-001 1.5 --note "first cut"
python3 cli/mazu.py check points US-001

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

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

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

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

04 同仓库更多 Skills