Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
e46878f848e223d55de4b510977cc6f81c04d05d
agent-skills/skills/i2s-problem-statement/SKILL.md
T
Philipp Sieder 6067d2ba0e feat(i2s-problem-statement): extract from monolith 
Step 5 of i2s-skill-split refactor. Second atomic sub-skill.

Contents:
- SKILL.md: 5 numbered phases (load context, 7 TAs, consistency,
  3 variants, export). description with explicit HMW/Problem-Statement
  triggers, anti-triggers naming klarheit-mit-idea2self (router),
  i2s-discovery, i2s-persona. Precondition check formalized.
- workflows/problem-statement.md: full workflow (git mv from monolith,
  rename detection preserved, required_reading paths updated to local
  curated refs).
- references/kommunikationsregeln.md: curated (PS-specific dialog
  heuristics: loesung-vs-problem, "alle als zielgruppe", widerspruch
  zu idee).
- references/problem-statement-format.md: curated extract from
  plugin-shared/export-formate.md, problem_statement_format block.
  Includes versions header rules and a filled example.
- references/artefakt-pipeline.md: curated (pipeline position +
  rueckwaerts-updates rules for PS -> ## Idee back-propagation).

Tools: Read, Write, Edit, Glob, Grep, AskUserQuestion, TodoRead,
TodoWrite. (No WebFetch/WebSearch — recherche lives in i2s-recherche.)
2026-05-19 01:16:01 +02:00

6.8 KiB
Raw Blame History

name, description, allowed-tools
name description allowed-tools
i2s-problem-statement Idea2Self Problem-Statement-Workflow. Formuliert das HMW-Statement (How Might We) ueber 7 gefuehrte Teilaspekte (WAS / WER / WARUM / WO / WANN / BISHERIGE ANSAETZE / WIE) und erzeugt 3 Varianten (wortgetreu / geschaerft / zugespitzt) zur Auswahl. Loest aus bei 'Problem-Statement erstellen', 'HMW formulieren', 'Wie koennen wir', 'Problem formulieren', 'Problem fuer meine Idee schaerfen', 'PS erstellen'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Persona erstellen' (i2s-persona), 'vage Idee strukturieren' ohne bestehende ## Idee Sektion (dafuer i2s-discovery zuerst). Vorbedingung: idea2self-Datei mit ausgefuellter ## Idee Sektion. Output: ## Problem-Statement Sektion in derselben Datei. Sprache: Deutsch. Read Write Edit Glob Grep AskUserQuestion TodoRead TodoWrite

i2s-problem-statement — Problem-Statement (HMW)

Schritt 2 im Idea2Self-Prozess. Formuliert aus der vagen ## Idee ein scharfes Problem-Statement im How Might We-Format. Erzeugt 3 Varianten zur Auswahl und schreibt die finale Version in die idea2self-Datei.

Essential Principles

  1. Aus Sicht der Zielgruppe, nicht der Loesung. Problem-Statement beschreibt das Beduerfnis, nicht den geplanten Ansatz. "Wie koennen wir [Kontext] fuer [Zielgruppe] neu gestalten, damit [Beduerfnis] befriedigt wird — unter Beruecksichtigung von [Einschraenkungen]."
  2. 7 Teilaspekte sind Pflicht, aber Tiefe ist adaptiv. Pro Teilaspekt 1 Leitfrage + max 1 Vertiefung. Wenn Nutzer schon klar geantwortet hat -> weiter. Wenn vage -> Vertiefung.
  3. Drei Varianten, dann eine. Wortgetreu / geschaerft / zugespitzt sind Sparring-Tool, nicht Output. Der Nutzer waehlt, kombiniert, der Skill iteriert max. 1× nach.
  4. Konsistenz gegen ## Idee. Wenn Problem-Statement der Idee widerspricht (andere Zielgruppe / anderes Problem): explizit benennen, Update auf ## Idee vorschlagen (Changelog-Eintrag).
  5. "Alle als Zielgruppe" ist nicht akzeptabel. Im PS-Workflow muss die Zielgruppe konkreter werden als in ## Idee. Wenn Nutzer ausweicht: Sub-Frage "Wer hat das Problem am DRINGENDSTEN?" einsetzen.

When to Use

  • ## Idee existiert in der idea2self-Datei, ## Problem-Statement fehlt oder soll iteriert werden.
  • Aus Router-Hand-off (Pfad 2) oder direkter Trigger ("Problem-Statement erstellen", "HMW").
  • Iteration nach Recherche: Nutzer hat neue Daten und will PS v0.2 schreiben.

When NOT to Use

  • ## Idee fehlt oder ist nur eine Ueberschrift -> erst i2s-discovery.
  • Nutzer will direkt zur Persona -> i2s-persona (PS bleibt erstmal vage).
  • Nutzer will den Loesungs-Ansatz schaerfen -> i2s-prototyp-konzept oder i2s-experiment-card.

Precondition Check

Vor Phase 1:

  1. idea2self-Datei laden (Pfad aus Nutzer-Prompt oder Standardort).
  2. Auf ^## Idee matchen + Sektion-Inhalt > 50 Zeichen.
  3. Fehlt -> abbrechen mit Hinweis: "## Idee fehlt in <datei>. Trigger zuerst i2s-discovery."

Phases

Phase 1 — Kontext laden + Voranalyse

Entry: Vorbedingung erfuellt.

Aktionen:

  1. Aus ## Idee extrahieren: Kern, Zielgruppen-Vermutung, Problem-Vermutung, Kontext, Einschraenkungen.
  2. Nutzer Voranalyse zeigen: "Aus deiner Idee lese ich: Problem = [X], Zielgruppe = [Y], Kontext = [Z]. Ich gehe jetzt 7 Teilaspekte mit dir durch. [1] von 7."
  3. Wenn ## Problem-Statement bereits existiert: Aenderungsmodus aktivieren — nur abweichende Aspekte durchgehen, Status mit Checkmarks zeigen.

Exit: Nutzer hat Voranalyse bestaetigt oder korrigiert.

Phase 2 — 7 Teilaspekte (gefuehrte Fragen)

Entry: Phase 1 abgeschlossen.

Aktionen:

  1. Pro Teilaspekt (siehe workflows/problem-statement.md Schritt 2): 1 Leitfrage stellen.
  2. Bei vager Antwort: 1 Vertiefungs-Frage.
  3. Anti-Pattern-Detection (Loesung statt Problem, Zielgruppe "alle", zu abstrakt, Beduerfnis unklar) — bei Match: Korrektur-Frage.
  4. Antworten als _(Vorschlag)_ oder _(Annahme)_ markieren, je nach Quelle.

Exit: Alle 7 TAs sind beruehrt (mit Antwort, "Ich weiss nicht", oder explizitem Ueberspringen).

Phase 3 — Konsistenzpruefung

Entry: 7 TAs durch.

Aktionen:

  1. Intern pruefen: Passt Zielgruppe zum Problem? Ist Beduerfnis aus Zielgruppen-Perspektive? Widerspricht etwas der ## Idee?
  2. Bei Inkonsistenz: explizit benennen, Anpassung vorschlagen.
  3. Bei Inkonsistenz zu ## Idee: Rueckwaerts-Update anbieten (siehe references/artefakt-pipeline.md).

Exit: Keine offenen Konsistenz-Konflikte, oder offene Konflikte sind als ## Offene Punkte in der Datei vermerkt.

Phase 4 — Drei Varianten erzeugen

Entry: Phase 3 abgeschlossen.

Aktionen:

  1. Variante A (wortgetreu): nah an Nutzer-Formulierungen, minimal verdichtet.
  2. Variante B (geschaerft): sprachlich praeziser, KI-Ergaenzungen als _(Vorschlag)_.
  3. Variante C (zugespitzt): schaerfster Fokus, Mentor-Ziele Loesbarkeit / Wichtigkeit / Erreichbarkeit.
  4. Drei Varianten zeigen, Nutzer waehlt oder kombiniert.
  5. Max. 1 Iteration nach Auswahl.

Exit: Eine finale PS-Variante ist gewaehlt.

Phase 5 — Export

Entry: Phase 4 abgeschlossen.

Aktionen:

  1. ## Problem-Statement Sektion in idea2self-Datei schreiben (Schema: references/problem-statement-format.md).
  2. Versions-Header (V1 fuer erste Erstellung, sonst V[prev+1]).
  3. Changelog-Eintrag: [Datum] PS V<n> formuliert / iteriert.
  4. Hand-off: "Dein Problem-Statement ist in der Datei. Naechster Schritt: Persona. Trigger: 'Persona erstellen' fuer i2s-persona. Oder 'Weiter'."

Exit: Datei aktualisiert, Hand-off ausgesprochen.

Quick Reference

Kommunikation: references/kommunikationsregeln.md. Pipeline + Rueckwaerts-Update-Regeln: references/artefakt-pipeline.md. Format-Schema: references/problem-statement-format.md. Workflow-Detail (alle 5 Schritte, alle 7 TAs, alle Anti-Patterns): workflows/problem-statement.md.

Reference Index

File Purpose
workflows/problem-statement.md Vollstaendiger 5-Schritt-Ablauf mit den 7 Teilaspekten + Anti-Patterns
references/kommunikationsregeln.md Tonalitaet, Marker, Steuerbefehle (curated)
references/problem-statement-format.md Markdown-Schema fuer ## Problem-Statement (HMW-Satz + 6 Sub-Sektionen)
references/artefakt-pipeline.md Pipeline-Position + Rueckwaerts-Update-Regeln (curated)

Success Criteria

  • Alle 7 Teilaspekte sind bearbeitet oder bewusst markiert.
  • HMW-Satz ist formuliert (Wie koennen wir [Kontext] fuer [Zielgruppe]...).
  • Zielgruppe ist konkreter als in ## Idee.
  • Problem ist aus Zielgruppen-Sicht formuliert, nicht aus Loesungs-Sicht.
  • Scope-Ausschluss ist explizit benannt (in ## Idee oder ## Problem-Statement).
  • idea2self-Datei enthaelt ## Problem-Statement mit Versions-Header + Changelog-Eintrag.
  • Hand-off zu i2s-persona ist ausgesprochen.
View Git Blame Copy Permalink