ms-ai-architect/scripts/skill-gen/prompt-template.md
Kjell Tore Guttormsen ced0c5f46d refactor(ms-ai-architect): R14 — persona ut av plugin-flaten, og de seks stedene som produserte den
Nøytral arkitekt-ramme (ratifisert 15.09) i SKILL.md-ene, 23 kommandoer, 70 redaksjonelle
forekomster i ref-korpuset, README/CLAUDE.md/NOTICE og A11Y-rapportens proveniens-linje.
Hver av de 70 avgjort i kontekst: dialog fikk ny taler, proveniens ny opphavspåstand.

Ordren navnga fem produsent-steder; den live sjette manglet. `PROMPT_TEMPLATE` settes i
generate-skills.sh:27 og leses ALDRI — prompten er en heredoc i samme script. Å rette bare
prompt-template.md ville latt generatoren re-minte personaen ved neste KB-kjøring.

Ny G4-klausul i check-cosmo-gate.mjs: persona i leveranseflaten = 0, derivasjonsregisteret
pinnet per fil PÅ TALL (et filnavn-unntak er blindt for hva fila senere inneholder).
Registeret utvidet med README.md 3 — versjonstabellens rader er historikk, ikke leveranse.
Den ene genitiv-formede produktlinja adjudiseres på cosmos-db-URL-en i samme rad; regelen
er målt lukket (8 tvetydige linjer totalt, 33 URL-linjer, 2 persona-klassifiserte, begge
produkt) og hvitvasker ikke bar `Cosmo`. classifyCosmo urørt — baselinene hviler på den.
R3 godtar nå R14-utført (0) men ingenting imellom: et halvveis sveip felles fortsatt.

Bevis: gate PASSED + NETTET VALIDERT BEGGE VEIER · 1137/1137 · validate-plugin 250/0/0 ·
begge --dry-drivere 0 · Layer B 45/45 OK (kjent-positiv feller, exit 1).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-15 23:15:27 +02:00

102 lines
3.7 KiB
Markdown

# Skill Generation Prompt Template
This template is used by `generate-skills.sh` to produce knowledge reference files for the architect plugin.
## Variables
- `{{SKILL_TITLE}}` — English title (e.g., "Azure AI Vision - Overview and Architecture")
- `{{SKILL_FILENAME}}` — Kebab-case filename without extension (e.g., "azure-ai-vision-overview")
- `{{CATEGORY_NAME}}` — Category name (e.g., "Azure AI Services (Foundry Tools)")
- `{{CATEGORY_DIR}}` — Directory name (e.g., "azure-ai-services")
- `{{CATEGORY_DESCRIPTION}}` — Category context
- `{{RELATED_SKILLS}}` — Other skills in same category (for cross-referencing)
- `{{EXISTING_CONTEXT}}` — Summary of existing reference files that overlap
## Prompt
```
Du er en senior Microsoft AI-løsningsarkitekt som skriver kunnskapsreferanser for et Claude Code-plugin. Referansene brukes av en arkitekturrådgiver som hjelper norske organisasjoner (spesielt offentlig sektor) med Microsoft AI-løsninger.
## Oppgave
Skriv en komplett kunnskapsreferanse om: **{{SKILL_TITLE}}**
Denne filen tilhører kategorien **{{CATEGORY_NAME}}**: {{CATEGORY_DESCRIPTION}}
## Format-krav (STRENGT)
Filen MÅ følge dette eksakte formatet:
### Header
```markdown
# {{SKILL_TITLE}}
**Last updated:** 2026-02
**Status:** [GA | Preview | Announced]
**Category:** {{CATEGORY_NAME}}
---
```
### Innhold (7-15 KB, alle seksjoner påkrevd)
1. **Introduksjon** (2-3 avsnitt)
- Hva er dette? Hvorfor er det viktig for enterprise AI?
- Plassering i Microsoft-økosystemet
- Norsk prosa, engelske tekniske termer
2. **Kjernekomponenter / Nøkkelegenskaper**
- Bruk tabeller for sammenligninger
- Bullet points for egenskaper
- Kodeeksempler der relevant (korte, illustrative)
3. **Arkitekturmønstre**
- 2-3 typiske bruksmønstre med ASCII-diagrammer der det hjelper
- Når bruke hvert mønster
- Fordeler og ulemper
4. **Beslutningsveiledning**
- "Velg X når..." beslutningstabell
- Vanlige feil og misforståelser
- Røde flagg arkitekten bør se etter
5. **Integrasjon med Microsoft-stakken**
- Hvordan dette kobles til andre Azure/M365-tjenester
- Typiske integrasjonsmønstre
6. **Offentlig sektor (Norge)**
- Spesielle hensyn for norsk offentlig sektor
- GDPR, Schrems II, AI Act, Forvaltningsloven
- Datasuverenitet og residency
7. **Kostnad og lisensiering**
- Prismodell (oversikt, ikke detaljerte tall)
- Inkludert i hvilke lisenser
- Kostnadsoptimaliseringstips
8. **For arkitekten**
- 5-8 nøkkelspørsmål å stille kunden
- Vanlige fallgruver
- Anbefalinger per modenhetsnivå (starter/intermediate/advanced)
9. **Kilder og verifisering**
- Referanser til Microsoft Learn-artikler
- Sist verifisert dato
- Konfidensnivå per seksjon (Documented / Baseline / Assumed)
## Regler
1. **Norsk prosa, engelske tekniske termer** — Skriv forklaringer på norsk, behold engelske termer for tjenester, konsepter og API-er
2. **Tabeller over tekst** — Bruk tabeller for sammenligninger, beslutninger, oversikter
3. **Konkret over vagt** — Spesifikke tall, konkrete eksempler, navngitte tjenester
4. **Balansert** — Vis både fordeler og ulemper, ikke bare markedsføringssnakk
5. **Oppdatert** — Bruk 2025-2026 informasjon, nevn GPT-5, AI Act, Foundry Tools (ny branding)
6. **Confidence markers** — Merk usikre påstander med (anslått) eller (uverifisert)
7. **Størrelse** — Mål: 7-15 KB (200-400 linjer). Ikke for kort (overfladisk) eller for langt (bloat)
8. **Ingen duplikering** — Ikke gjenta informasjon som allerede finnes i: {{EXISTING_CONTEXT}}
## Relaterte skills i samme kategori
{{RELATED_SKILLS}}
Skriv KUN markdown-innholdet. Ingen innledende forklaring eller avsluttende kommentar.
```