refactor(skills): migrate all 8 SKILL.md to pure-XML + apply audit fixes
Pure-XML body structure per marketplace-tools use-xml-tags.md (DEC-0013 D-XML, founder-approved): all markdown headings removed from skill bodies, replaced with semantic tags (<objective>, <quick_start>, <success_criteria> required; <essential_principles>, <when_to_use>, <when_not_to_use>, <precondition_check>, <workflow>, <reference_guides>, plus router <routing>/<intake>/<file_convention>/<guardrails>). Phases kept as bold labels inside <workflow>. Frontmatter (name, description, allowed-tools, metadata.version) preserved; all reference paths intact. Audit fixes (REV 2026-05-21) folded into the per-skill migration: - F1 i2s-persona: drop inline-research line (no WebFetch/WebSearch declared) -> point to i2s-recherche. - F2 i2s-discovery: web_search -> WebSearch (correct tool name). - F3 i2s-discovery/experiment-card/prototyp-konzept: document that WebFetch/WebSearch fire only on explicit confirmation for a single lookup (full research lives in i2s-recherche). - F4 router: shorten 897-char description to ~480 (exhaustive trigger list lives in references/routing-table.md). - F5 i2s-experiment-card: soften description preconditions (v0.2 preferred, not enforced — matches the actual precondition check). Verification (8 checks): no markdown headings, 3 required tags/skill, frontmatter integrity, XML tags balanced (code-fence aware), local refs resolve, 8 skills, gitignore present, drift-check exit 0. All green. 8 parallel general-purpose subagents (one per SKILL.md, disjoint files).
This commit is contained in:
Philipp Sieder
+25
-21
@@ -6,40 +6,44 @@ metadata:
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# i2s-persona — Verhaltensbasierte Persona
|
||||
|
||||
<objective>
|
||||
Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konkrete, verhaltensbasierte Persona — keine demografische Hochrechnung, sondern eine Arbeitshypothese mit Jobs-to-be-Done und Gains.
|
||||
</objective>
|
||||
|
||||
## Essential Principles
|
||||
<quick_start>
|
||||
Trigger: "Persona erstellen". Vorbedingung: idea2self-Datei mit ausgefuellter `## Problem-Statement` Sektion. Ablauf: Kontext laden -> 5 Teilaspekte gefuehrt durchgehen -> Konsistenz pruefen -> 3 Varianten -> finale Variante als `## Persona` in dieselbe Datei schreiben. Output: `## Persona` Sektion mit Versions-Header + Changelog.
|
||||
</quick_start>
|
||||
|
||||
<essential_principles>
|
||||
1. **Verhaltensbasiert, nicht demografisch.** Eine Persona ist "wie verhaelt sie sich", nicht "wer sie ist". Demografie liefert Anker, JTBD und Gains liefern Handlungsbasis.
|
||||
2. **Eine Person, kein Segment.** Eine konkrete Anker-Person (Name, Alter, Wohnsituation), nicht Aggregat-Daten. Hypothese, klar als solche markiert.
|
||||
3. **JTBD ist Aufgabe, nicht Loesung.** "Ich will mein Werkzeug ausleihen ohne App-Account zu machen" ist ein Job. "Ich will deine Tauschboerse nutzen" ist nicht.
|
||||
4. **Konsistenz zum Problem-Statement.** Wenn die Persona-Eigenschaften dem PS widersprechen (andere Werte, andere Lebenswelt), ist das ein Signal fuer Rueckwaerts-Update — nicht fuer kreative Verbiegung.
|
||||
5. **Belastbare Arbeitshypothese > perfektes Profil.** Wir formulieren v0.1. Recherche und Interviews ueberarbeiten in v0.2.
|
||||
</essential_principles>
|
||||
|
||||
## When to Use
|
||||
|
||||
<when_to_use>
|
||||
- `## Idee` UND `## Problem-Statement` existieren in idea2self-Datei, `## Persona` fehlt oder soll iteriert werden.
|
||||
- Aus Router-Hand-off (Pfad 3) oder direkter Trigger ("Persona erstellen", "Zielgruppe definieren").
|
||||
- Iteration nach Recherche: v0.2 nach neuen Daten aus i2s-recherche.
|
||||
</when_to_use>
|
||||
|
||||
## When NOT to Use
|
||||
|
||||
<when_not_to_use>
|
||||
- `## Problem-Statement` fehlt -> erst `i2s-problem-statement`.
|
||||
- Nutzer will Marktrecherche / Wettbewerbsanalyse -> `i2s-recherche`.
|
||||
- Nutzer will den Loesungs-Ansatz schaerfen -> `i2s-prototyp-konzept`.
|
||||
</when_not_to_use>
|
||||
|
||||
## Precondition Check
|
||||
|
||||
<precondition_check>
|
||||
**Vor Phase 1:**
|
||||
1. idea2self-Datei laden.
|
||||
2. Auf `^## Problem-Statement` matchen + Sektion-Inhalt > 100 Zeichen.
|
||||
3. Fehlt -> abbrechen mit Hinweis: "`## Problem-Statement` fehlt. Trigger zuerst `i2s-problem-statement`."
|
||||
</precondition_check>
|
||||
|
||||
## Phases
|
||||
<workflow>
|
||||
|
||||
### Phase 1 — Kontext laden + Voranalyse
|
||||
**Phase 1 — Kontext laden + Voranalyse**
|
||||
|
||||
**Entry:** Vorbedingung erfuellt.
|
||||
|
||||
@@ -50,7 +54,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
|
||||
|
||||
**Exit:** Voranalyse bestaetigt oder korrigiert.
|
||||
|
||||
### Phase 2 — 5 Teilaspekte (gefuehrte Fragen)
|
||||
**Phase 2 — 5 Teilaspekte (gefuehrte Fragen)**
|
||||
|
||||
**Entry:** Phase 1 abgeschlossen.
|
||||
|
||||
@@ -61,11 +65,11 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
|
||||
4. TA4 GEWINNE (3 vorausgewaehlte Gains-Leitfragen analog).
|
||||
5. TA5 ERGAENZUNGEN (was macht diese Persona einzigartig).
|
||||
6. Anti-Pattern-Detection (Stereotyp, JTBD als Loesung, zu viele Merkmale, Widerspruch zu PS).
|
||||
7. Inline-Recherche nur fuer Berufsbezeichnungen / Lebensstil-Begriffe. NICHT Zielgruppen-Studien (gehoert in `i2s-recherche`).
|
||||
7. Keine Web-Recherche in diesem Skill. Echte Recherche zu Zielgruppe / Lebenswelt gehoert in `i2s-recherche` (dieser Skill hat kein Web-Tool).
|
||||
|
||||
**Exit:** Alle 5 TAs beruehrt + Anti-Patterns geprueft.
|
||||
|
||||
### Phase 3 — Konsistenzpruefung
|
||||
**Phase 3 — Konsistenzpruefung**
|
||||
|
||||
**Entry:** 5 TAs durch.
|
||||
|
||||
@@ -76,7 +80,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
|
||||
|
||||
**Exit:** Keine offenen Konsistenz-Konflikte.
|
||||
|
||||
### Phase 4 — Drei Varianten erzeugen
|
||||
**Phase 4 — Drei Varianten erzeugen**
|
||||
|
||||
**Entry:** Phase 3 abgeschlossen.
|
||||
|
||||
@@ -89,7 +93,7 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
|
||||
|
||||
**Exit:** Eine finale Persona-Variante ist gewaehlt.
|
||||
|
||||
### Phase 5 — Export
|
||||
**Phase 5 — Export**
|
||||
|
||||
**Entry:** Phase 4 abgeschlossen.
|
||||
|
||||
@@ -102,25 +106,25 @@ Schritt 3 im Idea2Self-Prozess. Wandelt das HMW-Statement plus Idee in eine konk
|
||||
|
||||
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
|
||||
|
||||
## Quick Reference
|
||||
</workflow>
|
||||
|
||||
<reference_guides>
|
||||
Kommunikation: `references/kommunikationsregeln.md`.
|
||||
Format-Schema: `references/persona-format.md`.
|
||||
Workflow-Detail: `workflows/persona.md`.
|
||||
|
||||
## Reference Index
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `workflows/persona.md` | Vollstaendiger 5-Schritt-Ablauf mit 5 TAs + Anti-Patterns + Facilitation-Heuristiken |
|
||||
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle, Persona-spezifische Dialog-Heuristiken (curated) |
|
||||
| `references/persona-format.md` | Markdown-Schema fuer `## Persona` (Persona-Profil-Tabelle + JTBD + Gains + Kontext) |
|
||||
</reference_guides>
|
||||
|
||||
## Success Criteria
|
||||
|
||||
<success_criteria>
|
||||
- [ ] Persona ist verhaltensbasiert (nicht nur Demografie).
|
||||
- [ ] JTBD und Gains sind als Hypothesen formuliert (mit `_(Vorschlag)_` / `_(Annahme)_` markiert).
|
||||
- [ ] Anker-Person ist konkret (Name, Alter, Wohnsituation).
|
||||
- [ ] Persona passt zum `## Problem-Statement` (keine offenen Widersprueche).
|
||||
- [ ] idea2self-Datei enthaelt `## Persona` mit Versions-Header + Changelog-Eintrag.
|
||||
- [ ] Hand-off zu `i2s-recherche` ist ausgesprochen.
|
||||
</success_criteria>
|
||||
|
||||
Reference in New Issue
Block a user