feat(lead): Erwähnungen in Lead-Skills aufnehmen

- Adressaten und Betroffene werden als echte Mentions geschrieben (Basecamp `person:<id>`-Link, Zammad `data-mention-user-id`), damit sie benachrichtigt werden
- Sascha wird nicht erwähnt, da Schreibzugriffe über seinen Account laufen
- Basecamp-Kommentare bleiben ohne `--notify`; Erinnerungen bleiben bei A3
- Betrifft lead-backlog, lead-meeting-followup, lead-meeting-prep und lead-radar (inkl. references/execute.md)
This commit is contained in:
m3ta-chiron committed 2026-11-05 10:30:06 +01:00
1 parent 38780da558
commit 27eefdc9cf
5 files changed
+24 -4

No files matched your search

+5
View File
@@ -41,6 +41,11 @@ Load the `basecamp` skill before any Basecamp CLI call; check flags with `baseca
Show the comment in the proposal exactly as it will be posted, marker included.
**Mentions**: name every colleague the comment addresses or affects (owner, new owner, whoever is asked something) as a real mention, so they get a notification. A plain name notifies no one. Do not mention Sascha: Basecamp and Zammad writes run under his account. A comment with no addressee gets no mention. Show the mention in the proposal as `@Vorname Nachname`.
- Basecamp: `[@Vorname Nachname](person:<person-id>)`, ID from `.okf/organization/`, fallback `basecamp people pingable --jq '.data[] | select(.name == "…")'`. Not a bare `@Name`: the CLI resolves it fuzzily and can hit the wrong person. Only people with access to the project are pingable; for anyone else, say so in the proposal.
- Zammad (internal note, `text/html`): `<a href="<zammad-url>/#user/profile/<uid>" data-mention-user-id="<uid>">Vorname Nachname</a>`, uid via `GET /api/v1/users/search?query=<login>`. A typed `@Name` is plain text there. Zammad subscribes the mentioned user to the ticket and notifies them. Mentions count only when the note is created, and only for agents with access to the ticket's group.
## Steps
### 1. Pull the data
+4 -4
View File
@@ -8,7 +8,7 @@ Reached from step 4 of `SKILL.md`. The approval protocol in `/home/sascha.koenig
2. Put the comment on the same object: one or two German sentences with the reason in `sascha-internal-communication-style`, ending in `(lead-radar, <Modus>, YYYY-MM-DD)`, then one empty line and the italic AI marker. Example (Markdown, the CLI converts it):
```md
Neuer Termin 06.11., der Lieferant hat uns die Rückmeldung für KW 45 zugesagt. (lead-radar, freitag, 2026-11-13)
[@Jannik Müller](person:<id>) Neuer Termin 06.11., der Lieferant hat uns die Rückmeldung für KW 45 zugesagt. (lead-radar, freitag, 2026-11-13)
*✨unterstützt durch KI✨*
```
@@ -18,7 +18,7 @@ Work through the list in number order. A failing item does not stop the run: not
## Basecamp
Write mentions as plain names (no `@`), and leave `--notify` off: the comment is the trail, reminders belong to automation A3.
Mention the addressees as described under **Mentions** in `SKILL.md` (`[@Name](person:<id>)`), so the comment notifies them. Beyond that, send no extra notifications: no `--notify`, no pings. Reminders belong to automation A3.
| Action | Command (check flags with `--agent --help`) |
|---|---|
@@ -48,10 +48,10 @@ curl -sf -X PUT -H "Authorization: Token token=$ZAMMAD_TOKEN" -H "Content-Type:
# internal note (the "why" comment for Zammad)
curl -sf -X POST -H "Authorization: Token token=$ZAMMAD_TOKEN" -H "Content-Type: application/json" \
"$ZAMMAD_URL/api/v1/ticket_articles" \
-d '{"ticket_id": <id>, "body": "<p>Grund</p><p><br></p><p><em>✨unterstützt durch KI✨</em></p>", "content_type": "text/html", "type": "note", "internal": true}'
-d '{"ticket_id": <id>, "body": "<p><a href=\"<zammad-url>/#user/profile/<uid>\" data-mention-user-id=\"<uid>\">Vorname Nachname</a>, Grund</p><p><br></p><p><em>✨unterstützt durch KI✨</em></p>", "content_type": "text/html", "type": "note", "internal": true}'
```
Every Zammad article this skill writes has `"internal": true` and ends with the italic AI marker after an empty line; send it as `text/html`, since plain text cannot render italics.
Every Zammad article this skill writes has `"internal": true` and ends with the italic AI marker after an empty line; send it as `text/html`, since plain text cannot render italics. Addressees go in as mention links (see `SKILL.md`); the note above shows the form.
## OKF