Files
agent-prod/skills/lead-radar/references/execute.md
T

58 lines
3.3 KiB
Markdown
Raw Normal View History

2026-11-01 15:59:55 +01:00
# Executing approved proposals
Reached from step 4 of `SKILL.md`. The approval protocol in `/home/sascha.koenig/p/PM/.okf/processes/it-basecamp-regeln.md` is the rule; this file is the mechanics.
## Order per item
1. Make the change.
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)
*✨unterstützt durch KI✨*
```
2026-11-01 15:59:55 +01:00
3. Read the object back and check the new value.
Work through the list in number order. A failing item does not stop the run: note command and error, go on, and report it at the end.
## Basecamp
Write mentions as plain names (no `@`), and leave `--notify` off: the comment is the trail, reminders belong to automation A3.
| Action | Command (check flags with `--agent --help`) |
|---|---|
| Change owner | `basecamp todos update <id> --assignee <person-id> --json` |
| Set date | `basecamp todos update <id> --due YYYY-MM-DD --json` |
| Comment | `basecamp comments create <id> - < <scratchpad-file>` (stdin keeps umlauts intact) |
| Move to list (same project) | `basecamp todos position <id> --to 1 --list <list-id> --json` |
| Complete | `basecamp todos complete <id> --json` |
| Read back | `basecamp todos show <id> --json` |
**Parking:**
- Inside 🔒 Meins: move to the Meins backlog list (ID in `systems/basecamp.md`).
- From 👥 IT or a project into 📥 Backlog / Ideenspeicher (another project; `position` cannot cross projects): create a to-do in 📥 Backlog with the original title, its context and a link to the original, then comment on the original with the link to the new item and complete it. Shown to the user as one proposal.
- A whole project: `Für dich: /lead-backlog <Projekt>`; it runs with its own approval.
2026-11-01 15:59:55 +01:00
**Cards** (card tables, e.g. Azubi board): comment with `basecamp comments create <card-id>`; moving cards between columns is the card owner's job, so propose it as a `Für dich:` point.
## Zammad
Allowed: set owner, internal note. Requires `ZAMMAD_TOKEN`; base URL from `ZAMMAD_URL`, default as in `tools/it-cockpit/cockpit.py`. Without a token, list the Zammad items as `Für dich:` points with ticket link.
```bash
# owner (owner_id = Zammad user id; resolve via GET /api/v1/users/search?query=<login>)
curl -sf -X PUT -H "Authorization: Token token=$ZAMMAD_TOKEN" -H "Content-Type: application/json" \
"$ZAMMAD_URL/api/v1/tickets/<id>" -d '{"owner_id": <uid>}'
# 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}'
2026-11-01 15:59:55 +01:00
```
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.
2026-11-01 15:59:55 +01:00
## OKF
Edit the concept files under `/home/sascha.koenig/p/PM/.okf/` as approved, set `generated.at` to today, then run the `validate` skill on the bundle. Git stays with Sascha: report the changed paths.