claude-plugins/plugins/redmine/skills/redmine/SKILL.md

name, description, version

name	description	version
redmine	Redmine-Projekte und -Tickets lesen/anlegen/aktualisieren/kommentieren via REST-API. Use when the user mentions "Redmine", "Ticket", "Issue in Redmine", "Meilenstein/Milestone" or das Projekt "pg-wissen".	0.1.0

Redmine (redmine.py)

Interagiert mit Redmine (https://redmine.inmedias.it) über die REST-API: Projekte und Tickets auflisten, anzeigen, anlegen, aktualisieren und kommentieren — über die mitgelieferte, self-contained redmine.py. Namen werden auf IDs aufgelöst (Projekt, Tracker, Status, Priorität).

Ausführen

redmine.py ist ein eigenständiges uv run --script (Inline-Deps: requests, python-dotenv). Aus dem Skill-Verzeichnis:

./redmine.py <befehl> ...

--json (vor dem Befehl) gibt jeweils die Rohdaten aus.

Kontext & Stammdaten

./redmine.py me                       # aktueller Benutzer (id, admin?, mail)
./redmine.py projects                 # sichtbare Projekte (id, identifier, name)
./redmine.py meta trackers            # Stammdaten: trackers | statuses | priorities

Tickets auflisten / anzeigen

./redmine.py issues --project pg-wissen                # offene Tickets (Default)
./redmine.py issues --project pg-wissen --status '*'   # alle (open|closed|*|Status-ID)
./redmine.py issues --assigned me --sort priority:desc
./redmine.py issues --query "Wiki" --limit 20          # Volltext im Betreff (~-Suche)
./redmine.py show 290 [--notes]                        # Ticket (optional mit Journalen)

Anlegen / Aktualisieren / Kommentieren

--project und --subject sind bei create Pflicht. Beschreibung inline (--description) oder aus Datei/stdin (--description-file -) übergeben — nicht als langes Shell-Argument (Sonderzeichen). Weitere Felder: --tracker, --status, --priority, --assigned me, --parent <id>, --done <0-100>.

./redmine.py create --project pg-wissen --subject "Titel" \
    --tracker Feature --description-file - < body.md
./redmine.py update 290 --status Erledigt --done 100 --notes "erledigt"
./redmine.py comment 290 "kurzer Kommentar"

Zugangsdaten

redmine.py bringt keinen Schlüssel mit. Jede/r hinterlegt einen eigenen API-Key als Umgebungsvariable oder in einer dotenv-Datei (Reihenfolge: ~/.config/dokumentierer/.env, dann Datei im Arbeitsverzeichnis, dann bereits gesetzte Env-Variablen). Siehe .env.example:

• REDMINE_URL — Basis-URL (z.B. https://redmine.inmedias.it)
• REDMINE_API_KEY — persönlicher API-Zugriffsschlüssel unter https://redmine.inmedias.it/my/account (rechts „API-Zugriffsschlüssel"). Fehlt der Schlüssel dort, ist der REST-Webservice noch nicht aktiviert (Administration → Konfiguration → API).

Hinweise

• Schreibzugriff nur in Projekten mit „Add/Edit issues"-Recht; ein Nicht-Admin kann keine Tickets in fremden Projekten ändern.
• Ein neues Milestone (Version) anzulegen erfordert das Recht manage_versions und ist über redmine.py nicht abgedeckt — dafür die Weboberfläche oder die REST-API (POST /projects/<id>/versions.json) nutzen.