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.
Процедура
- Для файла выбрать вид:
import csv,import jira-csv,import youtrack-csvилиimport xlsx. - Запустить команду и прочитать число записей в stdout. Не выдумывать ключи.
- Для живого трекера сначала
python3 cli/mazu.py connectors. Команда говорит, заданы ли переменные, и не печатает их значения. - Если токена нет, остановиться и предложить файл. Не говорить «синхронизировано».
- Если токен есть:
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
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