AGENT SKILL

backlog-connectors

Читает CSV, Jira, YouTrack и Excel. Без токена не притворяется, что синхронизация прошла.

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

01 前言 Front Matter

name
backlog-connectors
description
Читает CSV, Jira, YouTrack и Excel. Без токена не притворяется, что синхронизация прошла.

03 SKILL.md 正文

Импорт бэклога

Файл — факт. Отсутствующий токен — остановка, не пустой успех. Импорт сохраняет внешний ключ и не подменяет им локальный id. Оценка вне ряда Фибоначчи не округляется до points и не становится часами.

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

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

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

  • Есть выгрузка CSV или xlsx.
  • Человек просит живой Jira или YouTrack.

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

  • Нужно придумать истории, которых нет в файле.
  • Нужно записать бэклог клиента в репозиторий метода.

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

  • Путь к файлу или явные переменные окружения.
  • Активный проект. См. скилл projects.

Процедура

  1. Для файла выбрать вид: import csv, import jira-csv, import youtrack-csv или import xlsx.
  2. Запустить команду и прочитать число записей в stdout. Не выдумывать ключи.
  3. Для живого трекера сначала python3 cli/mazu.py connectors. Команда говорит, заданы ли переменные, и не печатает их значения.
  4. Если токена нет, остановиться и предложить файл. Не говорить «синхронизировано».
  5. Если токен есть: pull jira --jql "..." или pull youtrack --jql "...". Успех — только код выхода 0.

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

  • Нет токена — ненулевой код и текст, что нужен CSV.
  • Чужая оценка не становится points.
  • Повторный импорт не должен тихо плодить дубли без внешнего ключа. Если ключ есть, это видно в show как external_id.

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

Делать

  • Называть источник в ответе: файл или pull.
  • После импорта прогнать list и показать первые id.

Не делать

  • Не вставлять токен в репозиторий, в вики и в ответ.
  • Не округлять 4 story points до 5.
  • Не объявлять двустороннюю синхронизацию. Этот набор умеет забрать и выгрузить файл, не вести живую пару.

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

  • show импортированной карточки содержит source и external_id, если они были в файле.
  • Код выхода pull приложен к слову «забрал», если оно сказано.

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

  • connectors показывает no, а ответ говорит, что задачи обновлены.
  • В store попали points, которых не было в ряде.
  • Импорт прошёл не в тот project.

Передача

Импортированные истории без сценария и границ не ready. Их забирает BDD и SDD, не спринт.

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

python3 cli/mazu.py project use alpha
python3 cli/mazu.py import jira-csv examples/jira.csv
python3 cli/mazu.py connectors
python3 cli/mazu.py export xlsx /tmp/backlog.xlsx

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

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

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

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

04 同仓库更多 Skills