Files
agent-prod/skills/lead-inbox/references/einrichten.md
T
m3ta-chironandClaude Fable 5.2 41175b6cf3 fix(lead): lead-inbox nach Trockenlauf und Einrichtung geschärft
Prüfung der gesendeten Mails vor Antwortvorschlägen, Sammelposten über
gefilterte Suche mit Trefferzahl, neue Muster (Asset Management, Metabase).

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-13 18:15:47 +01:00

6.7 KiB

One-time setup (/lead-inbox einrichten)

Five steps, in this order. Each step is shown to Sascha with what it will change and waits for its own approval. Facts (folder list, cut-off date, rule table) come from /home/sascha.koenig/ap/PM/.okf/systems/outlook.md; after each step set the matching Status there (an OKF change, shown with the step and validated with the validate skill).

Before step 1 note manage_mail_folder(action='get_details') for Inbox and Archive (total and unread). The numbers go into the final report.

1. Folders

manage_mail_folder(action='list'), then for each missing folder of the table "Ordner": manage_mail_folder(action='create', folder_name='<Name>', parent_folder='Inbox'). Existing folders are skipped, never renamed.

Done when list shows all six folders under Inbox.

2. Backlog cut-off

Everything received before the cut-off date goes to Archive unseen. The connector moves at most one fetch (100 mails) at a time, so loop:

  1. search_emails(folder='Inbox', inference_classification='all', start_date='2015-01-01', end_date='<day before cut-off>T23:59').
  2. The cache numbers are 1..count; no browsing needed. Note Inbox's total from get_details.
  3. manage_emails(action='archive_multiple', cache_numbers=[1 … count]).
  4. Compare the returned count of moved mails with the fetch's count.
  5. Next fetch.

Stop and report when failed_count > 0, or when Inbox's total did not drop by the batch size (the move did not take effect). Tell Sascha the progress every five batches. With about 3,500 mails expect about 35 batches.

Done when the search returns count: 0, and Inbox + Archive totals equal the totals noted before the step (name any difference; new mail arriving meanwhile explains a few).

3. Presort from the cut-off date

Read the mails from the cut-off date to today day by day, as in step 1 of SKILL.md. Every mail matching a row in muster.md with a target folder becomes part of one batch item per folder. Present the batch items (count plus the list of subjects per folder), and after approval move them per pattern with the search-scoped batch method in ausfuehren.md ("Batch items without browsing"). If Sascha has created the Outlook rules, ask him to run them once on the inbox first (Regeln → "Regel jetzt ausführen"): that sorts the stock in one go. Rows marked "stays in Inbox" are left alone.

Done when no mail with [Ticket# in the subject is left in Inbox, and a sample of ten mails per target folder fits its pattern. What remains is the input of the first triage run.

4. Outlook rules

The connector cannot create rules, and the skill runs none of the commands below. Give Sascha both forms:

  • the rule table from systems/outlook.md, for clicking the rules together in Outlook, and
  • the Exchange Online PowerShell block below, filled from that table. The table decides; if it differs from this block, follow the table and say so.
# Once per machine, if Connect-ExchangeOnline is "not recognized":
Install-Module ExchangeOnlineManagement -Scope CurrentUser
Import-Module ExchangeOnlineManagement

Connect-ExchangeOnline -UserPrincipalName sascha.koenig@azintec.com
# "A window handle must be configured" (seen 13.11.2026, module 3.11.1): add -DisableWAM
$mb = "sascha.koenig@azintec.com"
# Folder names depend on the mailbox language. Check the real paths first:
Get-MailboxFolderStatistics $mb -FolderScope Inbox | ft Name,FolderPath
# If the inbox is shown as /Posteingang, replace "Inbox" below accordingly.

New-InboxRule -Mailbox $mb -Name "lead-inbox 01 Helpdesk" -FromAddressContainsWords "bot@az-gruppe.com" -SubjectContainsWords "[Ticket#" -MoveToFolder "${mb}:\Inbox\Helpdesk" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 02 Alarme" -FromAddressContainsWords "MSSecurity-noreply@microsoft.com","Office365Alerts@microsoft.com","budgets@costalerts.amazonaws.com","quarantine@messaging.microsoft.com" -MoveToFolder "${mb}:\Inbox\Alarme" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 03 Belege" -SubjectContainsWords "Invoice","Zahlungsbeleg","receipt","Neue Rechnungen sind jetzt verfügbar" -ExceptIfFromAddressContainsWords "@azintec.com" -MoveToFolder "${mb}:\Inbox\Belege" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 04 Kalender" -MessageTypeMatches CalendaringResponse -MoveToFolder "${mb}:\Inbox\Kalender" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 05 Newsletter" -FromAddressContainsWords <newsletter senders from muster.md, quoted and comma-separated> -MoveToFolder "${mb}:\Inbox\Newsletter" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 06 Codes" -SubjectContainsWords "OTP","login code","passcode","Verification Code","sicherer Link zu Claude" -MoveToFolder "${mb}:\Inbox\Codes" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 07 Workist-Bericht" -FromAddressContainsWords "noreply@workist.com" -SubjectContainsWords "Dein Workist Fortschrittsbericht" -MoveToFolder "${mb}:\Inbox\Newsletter" -StopProcessingRules $true -WhatIf
New-InboxRule -Mailbox $mb -Name "lead-inbox 08 Basecamp-Community" -FromAddressContainsWords "notifications@app.basecamp.com" -SubjectContainsWords "Basecamp (Community)" -MoveToFolder "${mb}:\Inbox\Newsletter" -StopProcessingRules $true -WhatIf

Get-InboxRule -Mailbox $mb | ft Name,Enabled,Priority

Write out rule 05 with the real sender list before handing the block over. Tell Sascha: run each line with -WhatIf first, then without it; rule 03 comes after 01 and 06 so that tickets and codes are sorted first; rules 07 and 08 can be removed once the reports are unsubscribed. No rule for Sage invoice approvals: they need action and stay in the inbox.

Done when Sascha reports which rules exist; set those rows to aktiv in systems/outlook.md.

5. Noise at the source

Not something the skill can do. Hand over the table "Lärm an der Quelle" from systems/outlook.md as Für dich: points, with where each setting lives as far as known:

  • Zammad: avatar → Profil → Benachrichtigungen. Switch off the escalation reminders; limit updates to "meine Tickets" and mentions.
  • Workist: unsubscribe link in the progress report.
  • Basecamp Community: notification settings of the Community account.
  • UPS Billing: change the invoice recipient in the UPS billing centre to accounting.

Done when the points are handed over. When Sascha reports one as done, set its status in systems/outlook.md.

Final report

In German: folders created, mails archived (count, totals before and after), mails presorted per folder, rules handed over, open Für dich: points, and the number of mails left in Inbox for the first triage run.