Jira Daily PM Radar

CI Status: local-only License: MIT

Ежедневный PM-радар по Jira: что изменилось со вчера, где текущий спринт завис, что в backlog уже пахнет, что плохо оформлено и что проджекту надо сделать сегодня.

Проект сделан как демонстрационный agent skill package: внутри есть Python 3.12 CLI, async Jira client, MCP server, Open Skill-папка, HTML-отчет, security gates и mock-режим без реальной Jira.

Быстрый старт (без клонирования)

Если у вас установлен uv, вы можете запустить радар мгновенно через uvx:

# Запуск с mock-данными (не нужна реальная Jira)
uvx --from git+https://github.com/letya999/jira-daily-pm-radar.git \
  jira-radar daily --project DEMO --mock --out reports/

Установка скилла

Шаг 1: Регистрация в Skills CLI

Используйте Skills CLI для мгновенной регистрации навыка во всех AI-агентах (Claude Code, Gemini CLI, Cursor и др.):

npx skills add -g letya999/jira-daily-pm-radar

После этого агент будет знать, как запускать радар через uvx. Никакого клонирования и настройки venv вручную не требуется.

Шаг 2: Настройка MCP клиента

Добавьте следующую конфигурацию в ваш MCP-клиент (например, ~/.claude/mcp.json):

{
  "mcpServers": {
    "jira-daily-pm-radar": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/letya999/jira-daily-pm-radar.git[mcp]",
        "jira-radar-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Работа с реальной Jira (через CLI)

export JIRA_BASE_URL=https://your-domain.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your_api_token

uvx --from git+https://github.com/letya999/jira-daily-pm-radar.git \
  jira-radar daily --project TWIN --board-id 123 --since yesterday --out reports/

Команды uvx:

• ... jira-radar doctor - проверка связи
• ... jira-radar daily - ежедневный отчет
• ... jira-radar sprint - статус спринта
• ... jira-radar backlog - аудит бэклога

Разработка

Для локальной разработки склонируйте репозиторий и используйте uv sync:

git clone https://github.com/letya999/jira-daily-pm-radar.git
cd jira-daily-pm-radar
uv sync --all-extras

Настройка (local-only)

Linux / macOS: bash scripts/setup.sh Windows: powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1

Запуск тестов и линтеров

uv run ruff format .
uv run ruff check .
uv run mypy src tests
uv run pytest

Skill

Skill лежит здесь: skills/jira-daily-pm-radar/SKILL.md. Главная идея: агент сначала читает SKILL.md, затем использует uvx для запусков.

Security gates

В проекте настроены:

• pre-commit (ruff, mypy, bandit, detect-secrets)
• GitHub Actions CI (lint, tests, security scan)

License

MIT