docs: bring skills and docs in line with the fixed code
Skills ask before using a working copy found in the user's folder and state its check level first. The drift of the queue models before the shock is stated in the caveats and the README. README shows how to run the check and the tests. The drift line names the month a gradual drive begins. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
parent
776325c680
commit
19858bbda9
SSH key fingerprint:
SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
13 changed files with 314 additions and 113 deletions
|
|
@ -82,9 +82,9 @@ delt, den er et antall saker». Spør: «Stemmer dette?» Regn ikke før brukere
|
|||
|
||||
Skriv tallene som en JSON-fil i brukerens arbeidsmappe, for eksempel `rettsstat-tall.json`. Formatet, feltnavnene og
|
||||
reglene står i `${CLAUDE_PLUGIN_ROOT}/docs/inndata.md`; les den før du skriver fila første gang. Feltnavnene skrives
|
||||
nøyaktig som der, uten æ, ø og å: koden ser bort fra felt den ikke kjenner, så en skrivefeil gir stille en
|
||||
standardverdi. Skriv i `merknad` hvor tallene kommer fra og hva som er regnet om. Finnes fila fra før, spør før du
|
||||
overskriver den.
|
||||
nøyaktig som der, uten æ, ø og å: et feltnavn verktøyet ikke kjenner, i et ledd eller i `styring`, stopper regningen
|
||||
med en melding som foreslår det riktige. Skriv i `merknad` hvor tallene kommer fra og hva som er regnet om; `merknad`,
|
||||
`kilde` og `kilder` kan også stå i hvert ledd. Finnes fila fra før, spør før du overskriver den.
|
||||
|
||||
## 4. Kjør diagnosen
|
||||
|
||||
|
|
@ -94,15 +94,27 @@ python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" di
|
|||
|
||||
- På Windows heter tolken `python`.
|
||||
- `<fil>` er hele stien til inndatafila.
|
||||
- Har brukerens arbeidsmappe en egen arbeidskopi av modellen (mappa `rettsstat-modell/` med `modell/kjor.py` inni),
|
||||
legger du til `--modell <hele stien til rettsstat-modell/modell>` før `diagnose`, og sier til brukeren: «Jeg bruker
|
||||
din egen versjon av modellen i rettsstat-modell.» Bruk ellers pluginens modell.
|
||||
- Bruk pluginens modell, med mindre brukeren har valgt en egen versjon (se under).
|
||||
|
||||
**En egen versjon av modellen.** Har brukerens arbeidsmappe en mappe `rettsstat-modell/` med `modell/kjor.py` inni,
|
||||
bruk den ikke uten å spørre: «Jeg ser en egen versjon av modellen i rettsstat-modell. Skal jeg bruke den, eller
|
||||
pluginens?» Velger brukeren den egne, kjør kontrollen på den først:
|
||||
|
||||
```
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" --modell <hele stien til rettsstat-modell/modell> kontroll --rask
|
||||
```
|
||||
|
||||
Si nivået til brukeren før du legger fram noe tall: linja som begynner med «Nivå» («bit for bit som notatet», «endret:
|
||||
…», eller uten numpy og scipy «ingen avvik i det som ble kjørt (…)», som da bare gjelder kjernen, fasiten og
|
||||
diagnosen). Kjør så diagnosen med `--modell <hele stien til rettsstat-modell/modell>` før `diagnose`. Er versjonen
|
||||
endret, si sammen med svaret at tallene kommer fra brukerens egen versjon av modellen, ikke fra notatets.
|
||||
|
||||
Exit-koder:
|
||||
- **0**: diagnosen er regnet. Gå til trinn 5.
|
||||
- **2**: feil i inndata. Gjengi meldingen fra skriptet med vanlige ord (den sier hvilket ledd og hvilket tall), rett
|
||||
tallet sammen med brukeren, vis den rettede tabellen og kjør på nytt. Slutter meldingen med «Uventet feil i …», er
|
||||
det en feil i koden, ikke i tallene: gjengi den og si at diagnosen ikke ble regnet.
|
||||
- **2**: feil i inndata. Gjengi meldingen fra skriptet med vanlige ord (den sier hvilket ledd og hvilket tall, eller
|
||||
hvilket feltnavn verktøyet ikke kjenner og hva det trolig skulle være), rett sammen med brukeren, vis den rettede
|
||||
tabellen og kjør på nytt. Slutter meldingen med «Uventet feil i …», er det en feil i koden, ikke i tallene: gjengi
|
||||
den og si at diagnosen ikke ble regnet.
|
||||
- **Annen kode, eller `python3` finnes ikke**: gjengi meldingen som den er og si at diagnosen ikke ble regnet. Gjett
|
||||
ikke på et svar.
|
||||
|
||||
|
|
|
|||
|
|
@ -31,11 +31,14 @@ Avklar hvilken av tre ting det er. Spør med vanlige ord, og foreslå svaret nå
|
|||
| Brukeren vil | Det er | Slik gjøres det |
|
||||
|---|---|---|
|
||||
| prøve andre verdier for parameterne, en annen styringsregel, beslutningsregel, sjokk eller tiltak | **et scenario**: ingen kode endres | ferdigheten `simuler` |
|
||||
| legge til noe modellen ikke har (for eksempel et pådrag som varierer over tid, kø i et ledd til, målestøy) | **en utvidelse**: en ny mekanisme ved siden av kjernen, med et grensetilfelle som gjenskaper kjernen eksakt | trinn 2–7 |
|
||||
| legge til noe modellen ikke har (for eksempel kø i et ledd til, målestøy, forskyvning mellom kategorier) | **en utvidelse**: en ny mekanisme ved siden av kjernen, med et grensetilfelle som gjenskaper kjernen eksakt | trinn 2–7 |
|
||||
| endre ligningene modellen allerede har (en annen funksjonsform, en annen tilbakekobling) | **en endring i kjernen** | trinn 2–7 |
|
||||
|
||||
Mye som ser ut som en endring, er et scenario: alle kjernens parametere kan overstyres i en scenariofil (se
|
||||
`${CLAUDE_PLUGIN_ROOT}/docs/scenarioformat.md`). Er det et scenario, si det og gå over til ferdigheten `simuler`.
|
||||
`${CLAUDE_PLUGIN_ROOT}/docs/scenarioformat.md`), og et pådrag som varierer over tid finnes alt som utvidelsen
|
||||
`paadrag_tidsserie`. Er det et scenario, si det og gå over til ferdigheten `simuler`. Unntaket er beslutningsreglene
|
||||
for påtale og budsjett (`simulate_endo`) med en annen strøm av saker ved start, for eksempel mer effektivt politi:
|
||||
den stopper scenariokjøreren, fordi regelen i kjernen bruker notatets startstrøm. Det er en endring i kjernen.
|
||||
|
||||
Kan mekanismen stå ved siden av kjernen, anbefal en utvidelse framfor å endre kjernen: notatets resultater ligger da
|
||||
fast, og grensetilfellet viser at de gjør det.
|
||||
|
|
@ -53,15 +56,18 @@ python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" ar
|
|||
- På Windows heter tolken `python`. Bruk hele stien.
|
||||
- Kopien har modellen, eksemplene, fasiten, testene, dokumentasjonen og en `LES-MEG.md`. Den trenger ikke numpy og
|
||||
scipy for å lages.
|
||||
- Finnes mappa og er ikke tom, nekter kommandoen (den skriver aldri over noe). Har brukeren en kopi fra før, bruk
|
||||
den.
|
||||
- Ferdighetene `diagnose`, `forlop` og `simuler` bruker kopien selv når arbeidsmappa har en `rettsstat-modell/`.
|
||||
- Finnes mappa og er ikke tom, nekter kommandoen (den skriver aldri over noe). Den nekter også en mappe inne i
|
||||
pluginen. Har brukeren en kopi fra før, kjør kontrollen på den (trinn 6) og si nivået før du bygger videre.
|
||||
- Ferdighetene `diagnose`, `forlop` og `simuler` spør om de skal bruke kopien når arbeidsmappa har en
|
||||
`rettsstat-modell/`, og sier hvilket nivå kontrollen gir den.
|
||||
- `modell/kontroll.py` i kopien har notatets sjekksummer som faste verdier; det er dem kontrollen måler mot. Endre
|
||||
den ikke: da sier kontrollen ikke lenger noe om notatet.
|
||||
|
||||
**Forskere som bruker git** kan i stedet klone pluginens repository (`https://git.fromaitochitta.com/open/dynamisk-rettsstat.git`),
|
||||
endre der og starte Claude Code med pluginen fra klonen: `claude --plugin-dir .` i mappa. Da bruker ferdighetene
|
||||
klonens modell direkte, og endringene kan sendes tilbake med `git format-patch`. Kontrollen vet ikke at en klone er
|
||||
en arbeidskopi: ved «endret» sier den at pluginens modell skal regne som notatet, og kaller det en feil. For en
|
||||
endring som er ment, er det en opplysning; si det til brukeren.
|
||||
klonens modell direkte, og endringene kan sendes tilbake med `git format-patch`. En klone er ikke merket som
|
||||
arbeidskopi, så ved «endret» sier kontrollen at det er en feil hvis det er pluginen slik den er installert, og en
|
||||
opplysning hvis modellen er endret med vilje. Si til brukeren hvilket av de to det er.
|
||||
|
||||
## 3. Finn stedet i modellen
|
||||
|
||||
|
|
@ -96,7 +102,7 @@ Få et ja på dette før du skriver kode.
|
|||
## 5. Gjør endringen
|
||||
|
||||
**En utvidelse.** Følg `${CLAUDE_PLUGIN_ROOT}/docs/utvidelser.md`: grensesnittet (`NAVN`, `BESKRIVELSE`,
|
||||
`PARAMETERE`, `simuler`, `grensetilfelle`, og valgfritt `BRUKER` og `sjekk`), malen mellom `<!-- mal:start -->` og
|
||||
`PARAMETERE`, `simuler`, `grensetilfelle`, og valgfritt `BRUKER`, `sjekk` og `GJENSKAPER_NOTATET`), malen mellom `<!-- mal:start -->` og
|
||||
`<!-- mal:slutt -->` og trinnene der. Kort:
|
||||
- Fila er `rettsstat-modell/modell/utvidelser/<navn>.py`, og `NAVN` er filnavnet uten `.py`.
|
||||
- Kopier løkka fra simulatoren du bygger på uendret, og legg mekanismen inn slik at den forsvinner i grensetilfellet.
|
||||
|
|
@ -104,6 +110,8 @@ Få et ja på dette før du skriver kode.
|
|||
- Standardverdiene i `PARAMETERE` bør være grensetilfellet.
|
||||
- `grensetilfelle()` kjører utvidelsen i grensetilfellet og kjernen med de samme forutsetningene, og returnerer
|
||||
største absolutte avvik.
|
||||
- Gjenskaper utvidelsen med standardverdiene en av notatets scenariofiler, oppgi dem i `GJENSKAPER_NOTATET`. Da
|
||||
sjekker testene grensetilfellet også uavhengig av utvidelsens egen `grensetilfelle()`, mot notatets datafiler.
|
||||
|
||||
**En endring i kjernen.** Endre `rettsstat-modell/modell/kjerne/sim.py` (og kopiene i `diagnose.py` og `forlop.py`
|
||||
når det trengs). Endre bare det hypotesen gjelder.
|
||||
|
|
@ -121,15 +129,22 @@ Kjør kontrollen på kopien etter hver endring:
|
|||
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" --modell <hele stien til rettsstat-modell/modell> kontroll
|
||||
```
|
||||
|
||||
- Den fulle kontrollen kjører hele notatets simulering og tar om lag ett til to minutter. Mens du prøver deg fram,
|
||||
kan du legge til `--rask` (hopper over den fulle kjøringen); kjør den fulle før du sier hva endringen gjør.
|
||||
- Kontrollen sammenligner med notatets resultater i `fasit/`: kjernens sjekksummer, utskriften fra diagnosen og
|
||||
forløpet på begge eksempelfilene, de 22 datafilene og utskriften fra `sim.py`, og grensetilfellet i hver
|
||||
utvidelse.
|
||||
- Den fulle kontrollen kjører hele notatets simulering og tar et par minutter. Mens du prøver deg fram, kan du legge
|
||||
til `--rask` (hopper over den fulle kjøringen av `sim.py`); kjør den fulle før du sier hva endringen gjør.
|
||||
- Kontrollen måler mot notatets egne sjekksummer, som står fast i `modell/kontroll.py`, ikke mot filene i kopien.
|
||||
Den har seks deler, nummerert slik i utskriften:
|
||||
1. kjernen (`sim.py`, `diagnose.py`, `forlop.py`) og fasiten (27 filer) mot notatets sjekksummer;
|
||||
2. diagnosen på begge eksempelfilene mot fasit, tegn for tegn;
|
||||
3. forløpet på begge eksempelfilene mot fasit;
|
||||
4. full kjøring av `sim.py`: de 22 datafilene og utskriften mot fasit (ikke med `--rask`);
|
||||
5. grensetilfellet i hver utvidelse, som skal gi avvik eksakt `0.0`;
|
||||
6. scenariokjøreren: notatets scenariofiler kjørt gjennom kopiens kjører, mot fasit (13 filer med `--rask`, 14 i
|
||||
den fulle).
|
||||
|
||||
Exit-koder: **0** bit for bit eller innenfor toleranse, **1** endret, **2** feil bruk, **3** numpy eller scipy
|
||||
mangler. Ved 3 er det som kunne kjøres uten dem, kjørt. Spør: «Kontrollen trenger to vanlige regnebiblioteker for
|
||||
Python, numpy og scipy. Skal jeg installere dem i en egen mappe for denne pluginen?» Bare hvis svaret er ja:
|
||||
mangler. Ved 3 er bare kjernen, fasiten og diagnosen kontrollert. Spør: «Kontrollen trenger to vanlige
|
||||
regnebiblioteker for Python, numpy og scipy. Skal jeg installere dem i en egen mappe for denne pluginen?» Bare hvis
|
||||
svaret er ja:
|
||||
|
||||
```
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" miljo --opprett
|
||||
|
|
@ -139,22 +154,25 @@ Gjengi det kommandoen sier, og kjør kontrollen på nytt.
|
|||
|
||||
**Les dommen for brukeren.** Den står i linja som begynner med «Nivå», nederst:
|
||||
- **«bit for bit som notatet»**: endringen flytter ingen av notatets resultater. For en utvidelse er det det som skal
|
||||
skje, og grensetilfellet er eksakt.
|
||||
skje, og grensetilfellet er eksakt. Står det «(uten full kjøring, --rask)», er `sim.py` ikke kjørt i sin helhet; si
|
||||
ikke at endringen er kontrollert før den fulle kontrollen er kjørt.
|
||||
- **«innenfor toleranse»**: hvert tall avviker med høyst én enhet i siste viste siffer, som med andre versjoner av
|
||||
numpy og scipy. Notatets resultater står.
|
||||
- **«ingen avvik i det som ble kjørt (…). Ikke kontrollert: …»**: numpy eller scipy mangler. Si hva som ikke er
|
||||
kontrollert, med kontrollens ord. Det er ikke en dom over endringen.
|
||||
- **«endret: …»**: noe har flyttet seg. Si det rett ut, og si hva:
|
||||
- hvilke datafiler som er endret, og største absolutte avvik per kolonne (står i detaljene). Bruk modellkartet,
|
||||
del (d), til å si hvilken figur eller tabell i notatet hver datafil hører til;
|
||||
- hvilke datafiler som er endret, og største absolutte avvik per kolonne (står i detaljene, under del 4 og 6).
|
||||
Bruk modellkartet, del (d), til å si hvilken figur eller tabell i notatet hver datafil hører til;
|
||||
- hvilke linjer i diagnosen, forløpet og utskriften fra `sim.py` som er endret (detaljene viser dem som «notatet» og
|
||||
«nå»), med tallene slik de står;
|
||||
- om kjernen er endret (punkt 1), og om et grensetilfelle ikke lenger er eksakt (punkt 5).
|
||||
- om kjernen eller fasiten er endret (del 1). Er fasiten endret, sier sammenligningene mot den ingenting om
|
||||
notatet.
|
||||
|
||||
En endret kjerne er en opplysning, ikke en feil: kontrollen sier det selv i en arbeidskopi. Men det skal sies
|
||||
tydelig, og **brukeren avgjør om endringen var ment**. Var den ment, gå videre. Flytter en utvidelse notatets
|
||||
resultater, eller er grensetilfellet ikke `0.0`, er noe galt i utvidelsen: finn feilen før du går videre.
|
||||
|
||||
Står det «uten full kjøring, --rask» eller «bare det som er kjørt» i nivålinja, gjelder dommen bare en del av
|
||||
kontrollen. Si det, og si ikke at endringen er kontrollert før den fulle kontrollen er kjørt.
|
||||
tydelig, og **brukeren avgjør om endringen var ment**. Var den ment, gå videre.
|
||||
- **En utvidelse som ikke gjenskaper kjernen** (del 5: «… gjenskaper ikke kjernen i grensetilfellet. Det er en feil i
|
||||
utvidelsen …»): det er en feil, også i en arbeidskopi, og resultatene utvidelsen gir, kan ikke brukes før den er
|
||||
rettet. Finn feilen før du går videre.
|
||||
|
||||
Gjengi tallene fra kontrollen slik de står. Regn ikke ut egne avvik.
|
||||
|
||||
|
|
|
|||
|
|
@ -41,8 +41,9 @@ Forløpet kan bruke tre ting til. Spør om dem, men bare når brukeren har talle
|
|||
| Hvor kraftig reagerer innsatsen: hvor mange prosent mer innsats per prosent over målet? | 3 (10 % over målet gir 30 % mer innsats) |
|
||||
| Hvor mange saker kom inn per måned før strømmen begynte å øke? | 95 % av kapasiteten |
|
||||
|
||||
De to første er regime A i notatet. Si det når du bruker dem. De legges i `styring` i fila; det tredje er
|
||||
`innstromning_for_okning` i leddet.
|
||||
De to første er regime A i notatet. Si det når du bruker dem. De legges i `styring` i fila (`forsinkelse` og
|
||||
`reaktivitet`); det tredje er `innstromning_for_okning` i leddet. Feltnavnene skrives nøyaktig som i
|
||||
`docs/inndata.md`: et navn verktøyet ikke kjenner, stopper kjøringen med et forslag til det riktige.
|
||||
|
||||
**Hvilket ledd.** Uten valg følger forløpet leddet diagnosen peker på. Vil brukeren se et annet ledd, oppgis navnet
|
||||
nøyaktig slik det står i fila.
|
||||
|
|
@ -58,11 +59,21 @@ python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" fo
|
|||
|
||||
- På Windows heter tolken `python`.
|
||||
- `<fil>` er hele stien til inndatafila.
|
||||
- Har brukerens arbeidsmappe en egen arbeidskopi av modellen (mappa `rettsstat-modell/` med `modell/kjor.py` inni),
|
||||
legger du til `--modell <hele stien til rettsstat-modell/modell>` før `forlop`, og sier til brukeren: «Jeg bruker din
|
||||
egen versjon av modellen i rettsstat-modell.»
|
||||
- Bruk pluginens modell, med mindre brukeren har valgt en egen versjon (se under).
|
||||
- En kjøring tar noen sekunder.
|
||||
|
||||
**En egen versjon av modellen.** Har brukerens arbeidsmappe en mappe `rettsstat-modell/` med `modell/kjor.py` inni,
|
||||
bruk den ikke uten å spørre: «Jeg ser en egen versjon av modellen i rettsstat-modell. Skal jeg bruke den, eller
|
||||
pluginens?» Velger brukeren den egne, kjør kontrollen på den først:
|
||||
|
||||
```
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" --modell <hele stien til rettsstat-modell/modell> kontroll --rask
|
||||
```
|
||||
|
||||
Si nivået til brukeren før du legger fram noe tall: linja som begynner med «Nivå» («bit for bit som notatet» eller
|
||||
«endret: …»). Kjør så forløpet med `--modell <hele stien til rettsstat-modell/modell>` før `forlop`. Er versjonen
|
||||
endret, si sammen med svaret at tallene kommer fra brukerens egen versjon av modellen, ikke fra notatets.
|
||||
|
||||
Exit-koder:
|
||||
- **0**: skriptet har svart. Det kan også bety at forløpet ikke ble regnet; se trinn 3.
|
||||
- **3**: numpy eller scipy mangler. Si i én setning: «Forløpet trenger to vanlige regnebiblioteker for Python, numpy og
|
||||
|
|
@ -76,7 +87,8 @@ Exit-koder:
|
|||
forløpet på nytt. Feiler installasjonen, gjengi meldingen og si at diagnosen fortsatt kan brukes uten tilleggene.
|
||||
- **2**: skriptet har stoppet med en melding. Les den:
|
||||
- *Feil i inndata*, *Fant ikke fila*, *ikke gyldig JSON* eller *Fant ikke leddet*: gjengi meldingen med vanlige ord,
|
||||
rett sammen med brukeren og kjør på nytt.
|
||||
rett sammen med brukeren og kjør på nytt. Et feltnavn verktøyet ikke kjenner, i et ledd eller i `styring`, gir
|
||||
*Feil i inndata* med et forslag til riktig navn («Mente du …?»).
|
||||
- Meldingen begynner med *Forløpet …* (for eksempel at leddet ikke var i balanse før økningen, at prognosen ikke er
|
||||
høyere enn strømmen før økningen, eller at den er for høy): tallene ligger utenfor det modellen dekker. Si det med
|
||||
vanlige ord. Spør om tallet for saker inn før økningen er kjent (uten det brukes 95 % av kapasiteten), og si at
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
name: simuler
|
||||
description: "Kjører modellens simuleringer i notatet Den dynamiske rettsstaten med egne forutsetninger: fra et spørsmål («hva om …») til en scenariofil, en kjøring, en tabell med nøkkeltall og tilbud om figur. Dekker styringen (forsinkelse, reaktivitet, MPC), parameterne, beslutningsreglene for påtale og budsjett, sjokk, tiltak (andel ledet utenom, mer kapasitet i domstolen) og sveip over én eller to parametere, og gjenskaper notatets figurer. Bruk når noen vil prøve modellen med andre forutsetninger, sammenligne regler eller tiltak, se hvor grensen for svingninger går, eller lage notatets figurer på nytt. Utløses av «hva om forsinkelsen er seks måneder», «kjør et scenario», «simuler», «sammenlign reglene», «sveip over», «hva skjer med et større sjokk», «lag figuren i notatet på nytt», «run a scenario», «simulate the model with other assumptions»."
|
||||
description: "Kjører modellens simuleringer i notatet Den dynamiske rettsstaten med egne forutsetninger: fra et spørsmål («hva om …») til en scenariofil, en kjøring, en tabell med nøkkeltall og tilbud om figur. Dekker styringen (forsinkelse, reaktivitet, MPC), parameterne, beslutningsreglene for påtale og budsjett, sjokk, tiltak (andel ledet utenom, mer kapasitet i domstolen) og sveip over én eller to parametere, og gjenskaper notatets figurer. Bruk når noen vil prøve modellen med andre forutsetninger, sammenligne regler eller tiltak, se hvor grensen for svingninger går, eller lage notatets figurer på nytt. Utløses av «hva om forsinkelsen er seks måneder», «hva om politiet blir mer effektivt», «kjør et scenario», «simuler», «sammenlign reglene», «sveip over», «hva skjer med et større sjokk», «lag figuren i notatet på nytt», «run a scenario», «simulate the model with other assumptions»."
|
||||
---
|
||||
|
||||
# Kjør modellen med egne forutsetninger
|
||||
|
|
@ -18,6 +18,7 @@ feltnavn eller JSON med mindre brukeren spør etter dem, eller viser at de kjenn
|
|||
- **Finn aldri på et tall.** Forutsetningene er brukerens eller notatets. Alt scenariofila ikke setter, er notatets
|
||||
verdier; si hvilke som er brukt når det betyr noe for svaret.
|
||||
- **Vis scenarioet med ord, og få et ja før du kjører.**
|
||||
- **Velg aldri på brukerens vegne** hvordan en endret grunnparameter skal behandles (trinn 2).
|
||||
- **Gjengi skriptets tall ordrett.** Regn aldri om, avrund aldri annerledes og «forbedre» aldri et tall. Vil brukeren
|
||||
vite hva som skjer med andre forutsetninger, endrer du scenarioet og kjører på nytt.
|
||||
- **Si hver gang** at parameterne er notatets stiliserte verdier, ikke kalibrert på norske data, og at kjøringene
|
||||
|
|
@ -48,6 +49,7 @@ verdier, side om side. To parametere gir et rutenett.
|
|||
| `sjokkstorrelse_kjede.json` | hvor mye betyr størrelsen på sjokket når domstolen er en flaskehals? |
|
||||
| `kvalitetssloyfe.json` | hva gjør kvalitetssløyfen med desentraliserte og koordinerte regler? |
|
||||
| `utvidelse_bolge.json` | hva etterlater en forbigående bølge i kriminalitetspresset, med og uten flaskehals? |
|
||||
| `uten_sjokk_kjede.json` | hvor mye driver modellen med kø i domstolen av seg selv, uten sjokk? Nullinjen for små virkninger (trinn 5) |
|
||||
|
||||
I undermappa `notatet/` ligger 21 scenariofiler som til sammen lager 20 av notatets 22 datafiler på nytt, det
|
||||
figurene i notatet tegnes fra (regimene i figur 4, scenario 1–5 med domstolen, robusthet, vippepunkt og de endogene
|
||||
|
|
@ -67,14 +69,37 @@ Beskriv scenarioet med ord før du kjører:
|
|||
verdier (styring, sjokk, parametere, regel).
|
||||
- **Over hvor mange måneder**, og hvor mange kjøringer det blir.
|
||||
|
||||
**Når spørsmålet endrer en grunnparameter.** Noen av parameterne bestemmer utgangspunktet modellen starter i: for
|
||||
eksempel politiets effektivitet (`gamma`), tilliten ved start, innsatsen ved start, det strukturelle pådraget og den
|
||||
naturlige avgangen (hele listen står under «`startlikevekt`» i `docs/scenarioformat.md`). «Hva om politiet blir 20 %
|
||||
mer effektivt» er en slik endring. Da står modellen ikke lenger i ro ved start, og uten et valg stopper kjøringen
|
||||
med en melding om det. Forklar de to veiene med vanlige ord, og la brukeren velge:
|
||||
|
||||
- **Start i ro med de nye verdiene** (`"startlikevekt": "kalibrer"`): utgangspunktet regnes om slik notatet
|
||||
kalibrerer sitt, så modellen starter i balanse også med den nye verdien. Da sammenlignes to verdener som begge
|
||||
starter i ro, og det er sjokket og tiltakene som skiller dem. Sammendraget sier hvilke verdier som ble regnet om,
|
||||
fra hva og til hva.
|
||||
- **Start i notatets utgangspunkt med den nye verdien** (`"startlikevekt": "ubalanse"`): modellen begynner å bevege
|
||||
seg før sjokket kommer, fordi utgangspunktet ikke lenger passer. Det viser hva endringen gjør med en kjede som var
|
||||
i balanse. Sammendraget sier hva som er ute av balanse, og hvor langt modellen har drevet fram til sjokket.
|
||||
|
||||
Velg aldri selv. Vet du før kjøringen at spørsmålet endrer en grunnparameter, spør med en gang; stopper kjøringen med
|
||||
meldingen, spør da.
|
||||
|
||||
**Beslutningsreglene for påtale og budsjett** (`simulate_endo`) tåler ikke en annen strøm av saker ved start: der
|
||||
stopper kjøringen uansett valg når politiets effektivitet, tilliten, innsatsen ved start, `eta` eller `ksat` endres.
|
||||
Si det rett ut: i den modellen er det en endring i kjernen, og det er ferdigheten `forbedre`. Den koblede modellen
|
||||
uten beslutningsregler (`simulate_chain`) kan ofte svare på det samme spørsmålet; tilby den.
|
||||
|
||||
Spør: «Skal jeg kjøre dette?» Kjør ikke før brukeren har sagt ja.
|
||||
|
||||
## 3. Skriv scenariofila
|
||||
|
||||
Skriv scenarioet som en JSON-fil i brukerens arbeidsmappe, med et kort `navn` uten mellomrom og en `beskrivelse` som
|
||||
sier spørsmålet med vanlige ord (den står øverst i sammendraget). Feltnavnene skrives nøyaktig som i
|
||||
`docs/scenarioformat.md`. Finnes fila fra før, spør før du overskriver den. Gi en ny variant et nytt `navn`, så
|
||||
resultatet fra forrige kjøring blir stående.
|
||||
`docs/scenarioformat.md`. Har brukeren valgt hvordan utgangspunktet skal behandles, står valget i `startlikevekt`.
|
||||
Finnes fila fra før, spør før du overskriver den. Gi en ny variant et nytt `navn`, så resultatet fra forrige kjøring
|
||||
blir stående.
|
||||
|
||||
## 4. Kjør
|
||||
|
||||
|
|
@ -84,13 +109,23 @@ python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" sc
|
|||
|
||||
- På Windows heter tolken `python`.
|
||||
- `<fil>` er hele stien til scenariofila. `<mappe>` er `resultater/<navn>` i brukerens arbeidsmappe, med hele stien.
|
||||
Finnes mappa med et tidligere resultat av samme scenario, erstattes det. Finnes den med andre filer, stopper
|
||||
kjøreren uten å skrive noe.
|
||||
- Har brukerens arbeidsmappe en egen arbeidskopi av modellen (mappa `rettsstat-modell/` med `modell/kjor.py` inni),
|
||||
legger du til `--modell <hele stien til rettsstat-modell/modell>` før `scenario`, og sier til brukeren: «Jeg bruker
|
||||
din egen versjon av modellen i rettsstat-modell.» Bruk ellers pluginens modell.
|
||||
- Et scenario med noen få kjøringer tar noen sekunder. MPC er tregt (om lag 7 sekunder per kjøring), og et rutenett
|
||||
med mange kjøringer tar tilsvarende lenger.
|
||||
Finnes mappa med et tidligere resultat fra kjøreren, erstattes de filene; andre filer blir stående. Finnes den med
|
||||
andre filer og uten et slikt resultat, stopper kjøreren uten å skrive noe.
|
||||
- Bruk pluginens modell, med mindre brukeren har valgt en egen versjon (se under).
|
||||
- Et scenario med noen få kjøringer tar noen sekunder. MPC er klart tregere, og et rutenett med mange kjøringer tar
|
||||
tilsvarende lenger.
|
||||
|
||||
**En egen versjon av modellen.** Har brukerens arbeidsmappe en mappe `rettsstat-modell/` med `modell/kjor.py` inni,
|
||||
bruk den ikke uten å spørre: «Jeg ser en egen versjon av modellen i rettsstat-modell. Skal jeg bruke den, eller
|
||||
pluginens?» Velger brukeren den egne, kjør kontrollen på den først:
|
||||
|
||||
```
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" --modell <hele stien til rettsstat-modell/modell> kontroll --rask
|
||||
```
|
||||
|
||||
Si nivået til brukeren før du legger fram noe tall: linja som begynner med «Nivå» («bit for bit som notatet» eller
|
||||
«endret: …»). Kjør så scenarioet med `--modell <hele stien til rettsstat-modell/modell>` før `scenario`. Er versjonen
|
||||
endret, si sammen med svaret at tallene kommer fra brukerens egen versjon av modellen, ikke fra notatets.
|
||||
|
||||
Exit-koder:
|
||||
- **0**: kjøringen er gjort. Gå til trinn 5.
|
||||
|
|
@ -103,15 +138,19 @@ Exit-koder:
|
|||
|
||||
Gjengi det kommandoen sier (blant annet om resultatene da kontrolleres bit for bit eller med toleranse), og kjør på
|
||||
nytt. Feiler installasjonen, gjengi meldingen og si at diagnosen fortsatt kan brukes uten tilleggene.
|
||||
- **2**: skriptet har stoppet med en melding. Les den:
|
||||
- *Feil i scenariofila …*: meldingen nevner feltet og de gyldige verdiene, og foreslår det nærmeste ved en
|
||||
- **2**: skriptet har stoppet med en melding, og ingenting er skrevet. Les den:
|
||||
- *Feil i scenariofila … startlikevekt: startpunktet er ikke en likevekt …*: en grunnparameter er endret. Gjengi
|
||||
hva meldingen sier er ute av balanse, med vanlige ord, og la brukeren velge en av de to veiene i trinn 2.
|
||||
- *Feil i scenariofila … parametere.P: simulate_endo i kjernen bruker 0,1 …*: beslutningsreglene tåler ikke
|
||||
endringen (trinn 2). Det er en endring i kjernen; tilby `simulate_chain` eller ferdigheten `forbedre`.
|
||||
- *Feil i scenariofila …* ellers: meldingen nevner feltet og de gyldige verdiene, og foreslår det nærmeste ved en
|
||||
skrivefeil. Gjengi den med vanlige ord, rett fila, vis endringen og kjør på nytt. Er det brukerens forutsetning
|
||||
som ikke er tillatt (for eksempel en andel over 1), spør hva som var ment.
|
||||
- *… er ikke gyldig JSON*: rett fila og kjør på nytt.
|
||||
- *Kjøringen … stoppet i kjernen*: kombinasjonen av forutsetninger gir ingen likevekt ved start eller en løsning
|
||||
som vokser over alle grenser. Si det med vanlige ord, og hvilken kjøring det gjaldt. Ingenting er skrevet. Endre
|
||||
aldri en forutsetning bare for at kjøringen skal gå; spør brukeren.
|
||||
- *--ut: mappa … finnes og har filer …*: velg en annen mappe og si hvilken.
|
||||
- *Kjøringen … stoppet i kjernen* eller *Kjøringen … ga verdier som ikke er endelige tall*: kombinasjonen av
|
||||
forutsetninger gir en regnefeil i kjernen eller en løsning som vokser over alle grenser. Si det med vanlige ord,
|
||||
og hvilken kjøring det gjaldt. Endre aldri en forutsetning bare for at kjøringen skal gå; spør brukeren.
|
||||
- *--ut: mappa … finnes og har filer …* eller *Kan ikke skrive i …*: velg en annen mappe og si hvilken.
|
||||
- *Uventet feil i …*: en feil i koden, ikke i scenarioet. Gjengi meldingen og si at kjøringen ikke ble gjort.
|
||||
- **Annen kode, eller `python3` finnes ikke**: gjengi meldingen og si at kjøringen ikke ble gjort. Gjett ikke på et
|
||||
svar.
|
||||
|
|
@ -119,24 +158,37 @@ Exit-koder:
|
|||
## 5. Presenter svaret
|
||||
|
||||
1. **Vis nøkkeltallene slik skriptet skrev dem.** Kjøreren skriver sammendraget til skjermen og til `sammendrag.md`.
|
||||
Vis tabellen (eller tabellene) under «Nøkkeltall» uendret, med linja «Slik leses tallene» under, og for
|
||||
Vis tabellen (eller tabellene) under «Nøkkeltall» uendret, med avsnittet «Slik leses tallene» under, og for
|
||||
beslutningsreglene budsjettvedtakene. Ikke avrund, regn om eller formater tallene på nytt, og ta ikke bort rader.
|
||||
Er tabellen svært stor, vis radene brukeren spurte om, og si hvor resten står.
|
||||
2. **Les den med vanlige ord**, kort: hva endringen gjør i modellen, i hvilken retning og hvor mye, med skriptets
|
||||
tall. Pek på det som er verdt å se: høyeste mot slutt (har forløpet funnet en ny balanse?), vedvarende svingning
|
||||
(spennet de siste 60 månedene), saksbehandlingstid og tillit, og kapasitet og andel ledet utenom der de endres.
|
||||
Si ikke mer enn tallene viser.
|
||||
3. **Forbehold** som alltid tas med:
|
||||
2. **Gjengi det sammendraget sier om utgangspunktet og om kjøringen**, ordrett:
|
||||
- de omregnede verdiene, når utgangspunktet er kalibrert på nytt («Referansetilstanden er kalibrert på nytt …»);
|
||||
- linjene under «Slik har modellen drevet før sjokket»;
|
||||
- linjene under «Merknader (kjøringen er ikke stoppet)», for eksempel at kriminaliteten går langt utenfor området
|
||||
modellen er laget for, eller at sjokket kommer etter slutten av kjøringen. Si hva det betyr for hvor mye tallene
|
||||
kan brukes.
|
||||
3. **Les tabellen med vanlige ord**, kort: hva endringen gjør i modellen, i hvilken retning og hvor mye, med
|
||||
skriptets tall. Pek på det som er verdt å se: høyeste mot slutt (har forløpet funnet en ny balanse?), vedvarende
|
||||
svingning (spennet de siste 60 månedene), saksbehandlingstid og tillit, og kapasitet og andel ledet utenom der de
|
||||
endres. Køen i domstolen står i måneder av innstrømningen før sjokket (4,6 betyr at køen tilsvarer 4,6 måneders
|
||||
saker inn), ikke i antall saker. Si ikke mer enn tallene viser.
|
||||
4. **Driften i modellene med kø.** Modellene der domstolen har kø (den koblede modellen, modellen med to sakstyper,
|
||||
beslutningsreglene og utvidelser med kjede), står ikke helt i ro ved start, heller ikke med notatets verdier: det
|
||||
som faller fra køen, blir aldri trukket fra kriminaliteten, så kriminaliteten og saksbehandlingstiden kryper sakte
|
||||
oppover også uten sjokk. Sammendraget viser hvor langt fram til sjokket. Er virkningen brukeren ser på liten,
|
||||
tilby å sammenligne med en kjøring uten sjokk med samme parametere og horisont (`"sjokk": {"faktor": 1}`; for
|
||||
notatets koblede modell over 240 måneder er det `uten_sjokk_kjede.json`), og si at driften må trekkes fra før
|
||||
virkningen tolkes.
|
||||
5. **Forbehold** som alltid tas med:
|
||||
- Parameterne er notatets stiliserte verdier (tabell 3 i notatet), ikke kalibrert på norske data, unntatt det
|
||||
scenarioet setter selv. Kjøringene viser modellens dynamikk, ikke prognoser. Rekkefølgen og retningen er
|
||||
poenget, ikke nivåene.
|
||||
- Kø, strøm og kapasitet er i modellens normaliserte enheter, ikke saker eller årsverk. 1,00 er nivået før
|
||||
sjokket.
|
||||
- Kø, strøm og kapasitet er normaliserte størrelser, ikke saker eller årsverk. 1,00 er nivået ved start.
|
||||
- Bare ett ledd har kø i modellen (domstolen); politi, påtale og kriminalomsorg har ikke kø.
|
||||
|
||||
Ta i tillegg med det som gjelder dette scenarioet, fra `${CLAUDE_PLUGIN_ROOT}/docs/forbehold.md` (for eksempel at
|
||||
beslutningsreglene er stiliserte, eller at andelen som kan ledes utenom er et rettspolitisk valg).
|
||||
4. **Si hvor filene ligger**: sammendraget, én CSV-fil per kjøring (én rad per måned) og `resultat.json` med alle
|
||||
6. **Si hvor filene ligger**: sammendraget, én CSV-fil per kjøring (én rad per måned) og `resultat.json` med alle
|
||||
parametere slik de ble brukt, versjonene og sjekksummene. Samme scenariofil gir samme filer, så kjøringen kan
|
||||
etterprøves.
|
||||
|
||||
|
|
@ -151,10 +203,11 @@ Spør: «Vil du se dette som en figur?» Lag den bare hvis svaret er ja.
|
|||
- **Én kurve per kjøring**, med kjøringens navn fra sammendraget i forklaringen (for eksempel «forsinkelse=6»).
|
||||
- **Aksene på norsk**: «Tid (måneder)» og størrelsen, for eksempel «Kriminalitet K», «Tillit», «Politiets innsats
|
||||
T», «Saksbehandlingstid i domstolen (måneder)», «Kapasitet (1,00 = ved start)» eller «Andel til domstolen». Hva
|
||||
kolonnene betyr, står i `docs/scenarioformat.md` («Tidsseriene per modell»).
|
||||
- **Ta med linja om hva 1,00 betyr** under figuren, som i sammendraget: «1,00 er nivået i referanselikevekten før
|
||||
sjokket for kriminaliteten K og politiets innsats T; tilliten er 0,80 der. Kapasitet: 1,00 er kapasiteten ved
|
||||
start.» Skriv i tillegg at tallene er modellens stiliserte dynamikk, ikke prognoser.
|
||||
kolonnene betyr, står i `docs/scenarioformat.md` («Tidsseriene per modell»). Køen `Q` i CSV-filene er i modellens
|
||||
enheter, ikke i måneder som i sammendraget; kall aksen «Kø i domstolen (modellens enheter)».
|
||||
- **Ta med forklaringen på hva 1,00 betyr** under figuren, slik sammendraget skrev den for denne kjøringen
|
||||
(«Slik leses tallene: …»; den er annerledes for modellene med kø og når utgangspunktet er ute av balanse). Skriv i
|
||||
tillegg at tallene er modellens stiliserte dynamikk, ikke prognoser.
|
||||
- Lagre figuren i resultatmappa og si hvor den ligger.
|
||||
|
||||
## Hva scenariokjøreren ikke gjør
|
||||
|
|
@ -166,9 +219,7 @@ Si det rett ut når spørsmålet ligger utenfor:
|
|||
modellens normaliserte størrelser.
|
||||
- **En mekanisme modellen ikke har** (for eksempel kø i flere ledd, målestøy, forskyvning mellom kategorier) kan
|
||||
ikke settes inn med en parameter. Den legges til som en utvidelse; det er ferdigheten `forbedre`.
|
||||
- **Endrer scenarioet** `P.gamma`, `P.Lam0` eller `P.T0`, regnes domstolens kapasitet og behandlingstid ikke om, og
|
||||
domstolen er da ikke lenger 95 % utnyttet før sjokket. Si det, og oppgi dem selv hvis brukeren vil ha det (se
|
||||
`docs/scenarioformat.md`).
|
||||
- **En annen startstrøm i beslutningsreglene** (trinn 2) er en endring i kjernen, ferdigheten `forbedre`.
|
||||
- Ingen kjøring kalibrerer modellen mot norske tidsserier eller lager prognoser.
|
||||
|
||||
## 7. Neste steg
|
||||
|
|
@ -176,5 +227,6 @@ Si det rett ut når spørsmålet ligger utenfor:
|
|||
Tilby det som passer:
|
||||
- en variant med én forutsetning endret, kjørt med nytt navn og vist ved siden av den første, med skriptets tall;
|
||||
- et sveip over forutsetningen brukeren er mest usikker på;
|
||||
- en kjøring uten sjokk som nullinje, når virkningen er liten;
|
||||
- notatets scenariofil for samme figur, for å se forskjellen mot notatets forutsetninger;
|
||||
- ferdigheten `forbedre`, hvis spørsmålet krever en mekanisme modellen ikke har.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue