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
@@ -1,45 +1,44 @@
|
||||
---
|
||||
name: i2s-experiment-card
|
||||
description: "Idea2Self Experiment-Card-Workflow. Formuliert die riskanteste Annahme als pruefbare Hypothese (Wir-glauben-dass-fuer-weil-Form), waehlt ein Minimum-Viable-Experiment (Strasseninterview / Online-Umfrage / Landing-Page-Test / Prototyp-Test / Beobachtung), definiert Metriken mit Entscheidungsschwellen UND eine Weiter/Aendern/Lassen-Entscheidungslogik. Loest aus bei 'Experiment-Card erstellen', 'Hypothese formulieren', 'MVE-Design', 'Minimum Viable Experiment', 'Annahme pruefen', 'Lean Startup Hypothese', 'Entscheidungsschwelle festlegen', 'Interview-Leitfaden fuer Idea2Self'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Recherche zur Idee' (i2s-recherche), 'Prototyp-Konzept' (i2s-prototyp-konzept), oder wenn Recherche-Report noch fehlt. Vorbedingung: idea2self-Datei mit ## Problem-Statement v0.2, ## Persona v0.2 und ## Recherche-Report. Output: ## Experiment-Card Sektion. Sprache: Deutsch."
|
||||
description: "Idea2Self Experiment-Card-Workflow. Formuliert die riskanteste Annahme als pruefbare Hypothese (Wir-glauben-dass-fuer-weil-Form), waehlt ein Minimum-Viable-Experiment (Strasseninterview / Online-Umfrage / Landing-Page-Test / Prototyp-Test / Beobachtung), definiert Metriken mit Entscheidungsschwellen UND eine Weiter/Aendern/Lassen-Entscheidungslogik. Loest aus bei 'Experiment-Card erstellen', 'Hypothese formulieren', 'MVE-Design', 'Minimum Viable Experiment', 'Annahme pruefen', 'Lean Startup Hypothese', 'Entscheidungsschwelle festlegen', 'Interview-Leitfaden fuer Idea2Self'. NICHT aktivieren bei: 'Idea2Self starten' (Router), 'Recherche zur Idee' (i2s-recherche), 'Prototyp-Konzept' (i2s-prototyp-konzept), oder wenn Recherche-Report noch fehlt. Vorbedingung: idea2self-Datei mit ## Problem-Statement, ## Persona und ## Recherche-Report (v0.2 bevorzugt). Output: ## Experiment-Card Sektion. Sprache: Deutsch."
|
||||
allowed-tools: Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
|
||||
metadata:
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# i2s-experiment-card — Hypothese + Experiment-Design
|
||||
|
||||
<objective>
|
||||
Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** riskanteste Annahme, formuliert sie als pruefbare Hypothese und designed das kleinstmoegliche Experiment, das diese Annahme bestaetigt oder widerlegt. Definiert Entscheidungsschwellen **vor** Durchfuehrung.
|
||||
</objective>
|
||||
|
||||
## Essential Principles
|
||||
|
||||
<essential_principles>
|
||||
1. **Eine Hypothese, nicht mehrere.** Wir testen die **riskanteste** Annahme — die, deren Wegfall das Konzept kippt. Andere Annahmen warten.
|
||||
2. **Hypothesen-Format ist Pflicht.** "Wir glauben, dass [Annahme] fuer [Zielgruppe] weil [Begruendung]." Ohne diese Struktur bleibt die Hypothese unpruefbar.
|
||||
3. **MVE, nicht MVP.** Minimum Viable **Experiment**, nicht Minimum Viable **Product**. Goal: Lernen, nicht Bauen. 5-10 Strasseninterviews schlagen 2 Wochen Landing-Page-Bau.
|
||||
4. **Entscheidungsschwellen VOR dem Experiment.** Nicht hinterher rationalisieren. "Ab welchem Wert wuerdest du sagen: das reicht?" muss vor dem ersten Interview beantwortet sein.
|
||||
5. **Drei Entscheidungs-Outcomes, nicht zwei.** Weitermachen / Aendern / Lassen — das **Lassen** ist die schwierigste, aber wichtigste Schwelle.
|
||||
</essential_principles>
|
||||
|
||||
## When to Use
|
||||
|
||||
<when_to_use>
|
||||
- `## Recherche-Report` existiert, `## Experiment-Card` fehlt oder soll iteriert werden.
|
||||
- Aus Router-Hand-off (Pfad 5) oder direkter Trigger ("Experiment planen", "MVE", "Hypothese formulieren").
|
||||
- Nach erstem Experiment-Lauf: neue Hypothese fuer naechste Schleife (v0.2).
|
||||
</when_to_use>
|
||||
|
||||
## When NOT to Use
|
||||
|
||||
<when_not_to_use>
|
||||
- `## Recherche-Report` fehlt -> erst `i2s-recherche`.
|
||||
- Nutzer will das Konzept selbst designen (Features, User Flow) -> `i2s-prototyp-konzept`.
|
||||
- Allgemeine Hypothesen-Generierung ohne Idea2Self-Kontext -> nicht modelliert.
|
||||
</when_not_to_use>
|
||||
|
||||
## Precondition Check
|
||||
|
||||
<precondition_check>
|
||||
**Vor Phase 1:**
|
||||
1. idea2self-Datei laden.
|
||||
2. Auf `^## Problem-Statement` UND `^## Persona` UND `^## Recherche-Report` matchen, jeweils > 100 Zeichen Inhalt.
|
||||
3. Fehlt eines davon -> abbrechen, Hand-off auf den voraussetzenden Sub-Skill.
|
||||
</precondition_check>
|
||||
|
||||
## Phases
|
||||
|
||||
### Phase 1 — Kontext laden
|
||||
<workflow>
|
||||
**Phase 1 — Kontext laden**
|
||||
|
||||
**Entry:** Vorbedingung erfuellt.
|
||||
|
||||
@@ -49,7 +48,7 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
|
||||
|
||||
**Exit:** Voranalyse bestaetigt oder Kandidaten-Annahmen-Liste korrigiert.
|
||||
|
||||
### Phase 2 — 5 Teilaspekte (gefuehrte Fragen)
|
||||
**Phase 2 — 5 Teilaspekte (gefuehrte Fragen)**
|
||||
|
||||
**Entry:** Phase 1 abgeschlossen.
|
||||
|
||||
@@ -59,11 +58,11 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
|
||||
3. **TA3 METRIKEN.** Pro Metrik: Entscheidungsschwelle ("Ab welchem Wert ist die Hypothese bestaetigt?"). Anti-Pattern: keine Schwelle -> "Was waere ein Ergebnis, bei dem du sagst: das lasse ich?"
|
||||
4. **TA4 INTERVIEW-LEITFADEN** (wenn TA2 = Interview): 3 wichtigste Fragen + Regeln (offene Fragen, keine Suggestiv, zuhoeren > reden, Eroeffnung + Abschluss).
|
||||
5. **TA5 ENTSCHEIDUNGSLOGIK.** Drei Schwellen festzurren: "Weitermachen wenn ...", "Aendern wenn ...", "Lassen wenn ...".
|
||||
6. Inline-Recherche zu Interview-Techniken / typischen Fehlern erlaubt (max 1× pro TA).
|
||||
6. Inline-Recherche zu Interview-Techniken / typischen Fehlern erlaubt (max 1× pro TA). Web-Tools (WebFetch/WebSearch) nur auf Bestaetigung des Nutzers und nur fuer die Klaerung einer einzelnen Interview-Technik nutzen — keine Markt- oder Wettbewerbs-Recherche (die gehoert nicht in diesen Skill, sondern nach `i2s-recherche`).
|
||||
|
||||
**Exit:** Alle 5 TAs sind beantwortet oder explizit als "Nicht erarbeitet" markiert.
|
||||
|
||||
### Phase 3 — Konsistenzpruefung
|
||||
**Phase 3 — Konsistenzpruefung**
|
||||
|
||||
**Entry:** 5 TAs durch.
|
||||
|
||||
@@ -76,7 +75,7 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
|
||||
|
||||
**Exit:** Keine offenen Konsistenz-Konflikte.
|
||||
|
||||
### Phase 4 — Export
|
||||
**Phase 4 — Export**
|
||||
|
||||
**Entry:** Phase 3 abgeschlossen.
|
||||
|
||||
@@ -87,25 +86,27 @@ Schritt 5 im Idea2Self-Prozess. Macht aus Recherche-Erkenntnissen die **eine** r
|
||||
4. Hand-off: "Experiment-Card ist fertig. Fuehre das Experiment durch — danach kommt das Prototyp-Konzept. Trigger: 'Prototyp-Konzept erstellen' fuer `i2s-prototyp-konzept`. Oder iteriere die Card via `klarheit-mit-idea2self` review-iterate."
|
||||
|
||||
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
|
||||
</workflow>
|
||||
|
||||
## Quick Reference
|
||||
<quick_start>
|
||||
Trigger: "Experiment planen" / "MVE-Design". Vorbedingung: `## Recherche-Report` (sowie `## Problem-Statement` + `## Persona`) existiert in der idea2self-Datei. Ablauf: 5 Teilaspekte (Hypothese, Experiment-Design, Metriken, Interview-Leitfaden, Entscheidungslogik) durchgehen, Schwellen vor Durchfuehrung festzurren. Output: `## Experiment-Card` Sektion. Detaillierte Quellen siehe Reference-Index unten.
|
||||
</quick_start>
|
||||
|
||||
<reference_guides>
|
||||
Kommunikation: `references/kommunikationsregeln.md`.
|
||||
Methodik (Lean Startup Build-Measure-Learn): `references/lean-startup.md`.
|
||||
Format-Schema: `references/experiment-card-format.md`.
|
||||
Workflow-Detail: `workflows/experiment-card.md`.
|
||||
|
||||
## Reference Index
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `workflows/experiment-card.md` | Vollstaendiger 4-Schritt-Ablauf mit 5 TAs + Anti-Patterns |
|
||||
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated) |
|
||||
| `references/lean-startup.md` | Build-Measure-Learn, MVE > MVP, Evidenz-Abstufungen (curated extract aus methodik) |
|
||||
| `references/experiment-card-format.md` | Markdown-Schema fuer `## Experiment-Card` |
|
||||
</reference_guides>
|
||||
|
||||
## Success Criteria
|
||||
|
||||
<success_criteria>
|
||||
- [ ] Hypothese im "Wir glauben, dass ... fuer ... weil ..." Format formuliert.
|
||||
- [ ] Risikostufe bewertet + begruendet.
|
||||
- [ ] Experiment-Typ gewaehlt, Mindest-Datenpunkte definiert.
|
||||
@@ -114,3 +115,4 @@ Workflow-Detail: `workflows/experiment-card.md`.
|
||||
- [ ] Interview-Leitfaden vorhanden (wenn Experiment-Typ = Interview).
|
||||
- [ ] idea2self-Datei enthaelt `## Experiment-Card` mit Versions-Header + Changelog-Eintrag.
|
||||
- [ ] Hand-off zu `i2s-prototyp-konzept` ist ausgesprochen.
|
||||
</success_criteria>
|
||||
|
||||
Reference in New Issue
Block a user