review-pr-diff

name	review-pr-diff
description	Genereer Nederlandstalige PR-summary uit diff.json, gegroepeerd per organisatie, met confidence-flags en high-stakes markers. Gebruik wanneer de gebruiker zegt 'review diff', 'maak PR-body', 'samenvatting diff', 'genereer PR-summary', of in English 'review diff', 'generate PR body', 'summarise daily run', of in CI na een dagelijkse fetcher-run.
version	0.2.0
triggers	["review diff","maak PR-body","genereer PR-summary","samenvatting diff","generate PR body","summarise daily run"]

review-pr-diff

Doel

Lees diff.json (en optioneel proposals.json) van een dagelijkse fetcher-run en produceer een Nederlandstalige PR-body als markdown. De skill samenvat per organisatie, markeert high-stakes wijzigingen, en flagt wijzigingen die menselijke review vereisen.

Input

• Verplicht: diff.json (output van polder-diff). Een JSON-array van entries met velden:
  • path (string, bijv. data/organisaties/ministeries/bzk.yaml)
  • type (modified of new)
  • changed_fields (lijst van JSONPath-strings)
  • high_stakes (bool)
  • before en after (volledige records)
• Optioneel: proposals.json met nieuwe records (type: new, record: {...}).
• Optioneel: proposals_llm.json met LLM-proposals plus confidence en confidence_reasoning per claim.

Output

Markdown-body. Schrijf naar stdout, of naar het pad in --out (bijv. pr-body.md).

Stappen voor de LLM

1. Laad diff.json. Als het bestand leeg of [] is, schrijf een eenregelige body: "Geen wijzigingen vandaag." en stop.

2. Laad proposals.json als die bestaat; voeg de entries toe aan de set "nieuwe records".

3. Laad proposals_llm.json als die bestaat; gebruik confidence-waarden voor de confidence-tabel.

4. Groepeer entries per organisatie. Bepaal de organisatie-key uit path:

   • Voor data/organisaties/<type>/<slug>.yaml: <type>/<slug> (de eerste twee path-segments na data/organisaties/).
   • Voor data/personen/... of data/posten/...: gebruik before.organization_id of after.organization_id indien aanwezig, anders een aparte sectie "Personen" of "Posten".
   • Mandaten staan binnen een organisatie-record en horen automatisch onder die organisatie.

5. Bouw markdown met deze structuur:

   # Dagelijkse update {datum-iso}
   
   **Samenvatting**: {N} organisaties gewijzigd, {M} nieuwe records, {K} high-stakes flags.
   
   ## High-stakes wijzigingen
   
   | Organisatie | Veld | Voor | Na | Bron |
   |---|---|---|---|---|
   | org:min-bzk | valid_until | null | 2026-05-01 | roo |
   
   ## Wijzigingen per organisatie
   
   ### Ministerie van BZK (`org:min-bzk`)
   
   - `valid_until`: `null` -> `2026-05-01` (organisatie opgeheven, bron-check vereist)
   - `names[0].abbr`: `BZK` -> `BZK&KR`
   
   ## Nieuwe records
   
   - `org:gemeente-amsterdam` (gemeenten, source: roo)
   
   ## Confidence-tabel (LLM-proposals)
   
   | Proposal | Confidence | Reden |
   |---|---|---|
   | Benoeming P. de Vries (BZK) | 0.91 | Onder drempel 0.95 |
   
   ## Vlaggen voor menselijke review
   
   - 3 wijzigingen met confidence < 0.95
   - 1 wijziging op rood-AVG-veld
   - 2 high-stakes wijzigingen (mandaten of opheffing)
   

6. Voor elke wijziging in een sectie: print het JSONPath uit changed_fields, en de waarde uit before en after voor dat pad. Render null als null. Strings binnen backticks.

7. Voor "high-stakes": elke entry met high_stakes: true krijgt een rij in de high-stakes-tabel. Veld = eerste high-stakes pad (mandaten... of valid_until). Bron = after.sources[0].id indien aanwezig.

8. Voor de confidence-tabel: alleen entries met confidence < 0.95 of die een rood-AVG-veld raken (zie hieronder).

9. Schrijf het resultaat naar --out als die optie meegegeven is, anders naar stdout.

Rood-AVG-velden

Volgens .claude/CLAUDE.md van het project. Behandel deze velden als rood en flag elke wijziging:

• birth.year (en alles onder birth.*)
• personal_email, personal_phone, home_address, en alle persoonlijke contactvelden
• Alles dat een BSN zou kunnen bevatten: pad bevat bsn of social_security

Harde regels

1. Niet zelf data wijzigen. Alleen samenvatten wat in diff.json, proposals.json en proposals_llm.json staat.
2. Wijzigingen met confidence < 0.95 of op een rood-AVG-veld komen verplicht in de confidence-tabel en in de Vlaggen-sectie.
3. Schrijf in het Nederlands. Korte zinnen, varieer ritme. Geen em-dashes; gebruik komma, punt of haakjes.
4. Per wijziging een directe verwijzing naar sources[].id of sources[].url indien aanwezig in after.
5. High-stakes wijzigingen (high_stakes: true) altijd in de eigen tabel bovenaan, ook als ze ook elders genoemd worden.

Voorbeeld

Zie example_diff.json voor input en example_output.md voor de bijbehorende output. Optionele helper-instructies voor het bouwen van de output staan in SCRIPT.md.

Aanroep in workflow

- name: Run Claude Code review
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: |
      Lees diff.json (en proposals.json indien aanwezig) en genereer een PR-body
      met de review-pr-diff skill. Schrijf de body naar pr-body.md.
    claude_args: "--model claude-haiku-4-5 --max-turns 5"

Aanroep vanuit Claude Code CLI

claude "Gebruik de review-pr-diff skill op diff.json en schrijf het resultaat naar pr-body.md"

Status

Actief, versie 0.2.0. Eerste skill die in CI draait.