Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
main
agent-skills/skills/i2s-persona/SKILL.md
T
Philipp Sieder 7691b408e8 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).
2026-05-22 09:47:54 +02:00

6.8 KiB
Raw Permalink Blame History

name, description, allowed-tools, metadata
name description allowed-tools metadata
i2s-persona Idea2Self Persona-Workflow. Erstellt eine verhaltensbasierte Zielgruppen-Persona (JTBD + Gains, nicht nur Demografie) in 5 Teilaspekten (Lebenswelt, Werte, Aufgaben, Gewinne, Ergaenzungen) und schreibt sie in die idea2self-Datei. Loest aus bei 'Persona erstellen', 'Zielgruppe definieren', 'verhaltensbasierte Persona', 'JTBD fuer Idea2Self', 'Gains und Aufgaben', 'wer ist die Zielgruppe konkret'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Problem-Statement erstellen' (i2s-problem-statement), 'vage Idee strukturieren' (i2s-discovery), wenn ## Problem-Statement noch fehlt. Vorbedingung: idea2self-Datei mit ausgefuellter ## Idee und ## Problem-Statement Sektion. Output: ## Persona Sektion in derselben Datei. Sprache: Deutsch. Read Write Edit Glob Grep AskUserQuestion TodoRead TodoWrite
version
1.0.0
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.

<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>

  • ## 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>

  • ## 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> 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>

Phase 1 — Kontext laden + Voranalyse

Entry: Vorbedingung erfuellt.

Aktionen:

  1. Aus ## Idee und ## Problem-Statement extrahieren: Zielgruppen-Beschreibung, Anker-Person (falls vorhanden), Beduerfnis.
  2. Nutzer Voranalyse zeigen: "Aus deinem PS lese ich: Zielgruppe = [X], Beduerfnis = [Y]. Ich gehe jetzt 5 Teilaspekte mit dir durch. [1] von 5."
  3. Wenn ## Persona bereits existiert: Aenderungsmodus aktivieren.

Exit: Voranalyse bestaetigt oder korrigiert.

Phase 2 — 5 Teilaspekte (gefuehrte Fragen)

Entry: Phase 1 abgeschlossen.

Aktionen:

  1. TA1 LEBENSWELT (Demografie + Verhalten im Alltag).
  2. TA2 WERTE (Glaubenssaetze, innere Spannungen).
  3. TA3 AUFGABEN (3 vorausgewaehlte JTBD-Leitfragen praesentieren — passen, austauschen, anpassen).
  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. 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

Entry: 5 TAs durch.

Aktionen:

  1. Verhaltensbasiert (nicht nur Demografie)? Wenn nicht: TA1/TA2 vertiefen.
  2. JTBD und Gains als Hypothesen formuliert (nicht als Fakten)? Wenn nicht: _(Vorschlag)_ / _(Annahme)_ ergaenzen.
  3. Widerspricht etwas dem ## Problem-Statement? Wenn ja: Rueckwaerts-Update anbieten (PS aktualisieren).

Exit: Keine offenen Konsistenz-Konflikte.

Phase 4 — Drei Varianten erzeugen

Entry: Phase 3 abgeschlossen.

Aktionen:

  1. Variante A (wortgetreu): nah am Dialog, offene Punkte sichtbar.
  2. Variante B (geschaerft): JTBD/Gains klarer, KI-Verdichtungen als _(Vorschlag)_.
  3. Variante C (zugespitzt): Annahmen-arm, Fokus auf Loesbarkeit / Wichtigkeit / Erreichbarkeit.
  4. Drei Varianten zeigen, Nutzer waehlt oder kombiniert.
  5. Max. 1 Iteration nach Auswahl.

Exit: Eine finale Persona-Variante ist gewaehlt.

Phase 5 — Export

Entry: Phase 4 abgeschlossen.

Aktionen:

  1. ## Persona Sektion in idea2self-Datei schreiben (Schema: references/persona-format.md).
  2. PS-Kontext-Import mit _(Aus Problem-Statement uebernommen)_ markieren.
  3. Versions-Header (V1 fuer Erstellung).
  4. Changelog-Eintrag: [Datum] Persona V<n> formuliert / iteriert.
  5. Hand-off: "Persona ist in der Datei. Naechster Schritt: Problemraum-Recherche. Trigger: 'Problemraum recherchieren' fuer i2s-recherche. Oder 'Weiter'."

Exit: Datei aktualisiert, Hand-off ausgesprochen.

<reference_guides> Kommunikation: references/kommunikationsregeln.md. Format-Schema: references/persona-format.md. Workflow-Detail: workflows/persona.md.

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>

  • 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>
View Git Blame Copy Permalink