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:
@@ -6,33 +6,36 @@ metadata:
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# i2s-discovery — Idea2Self Discovery-Interview
|
||||
|
||||
<objective>
|
||||
Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Schritt-Interview, das eine vage Idee in eine strukturierte Idee + persoenliche Passung + Scope-Ausschluss verwandelt. Legt am Ende die zentrale `idea2self-<kurztitel>.md` Datei an.
|
||||
</objective>
|
||||
|
||||
## Essential Principles
|
||||
|
||||
<essential_principles>
|
||||
1. **Adaptiv nach Ideen-Typ.** Nach 2-3 Orientierungs-Fragen klassifizieren (Produkt / Wissen / Community / Content / Physisches / unklar). Folgefragen sind typ-spezifisch — generische Fragenliste ist Sediment.
|
||||
2. **Persoenliche Passung ist Pflicht.** "Warum ich?" — ohne Verbindung zwischen Idee und Founder-Staerken/-Motivation bleibt die Datei tot. Wenn Nutzer ausweicht: konkrete Sub-Frage stellen ("Wer in deinem Netzwerk hat das Problem konkret?").
|
||||
3. **Scope-Ausschluss vor Bestaetigung.** "Was wird bewusst NICHT gebaut?" gehoert in Schritt 2, nicht nachgelagert. Ohne Ausschluss bleibt der Scope diffus und der Action-Plan spaeter unmoeglich.
|
||||
4. **Widerspruch wird benannt, nicht ignoriert.** "Einfach UND umfassend", "alle als Zielgruppe", "Loesung ohne Problem" — explizit thematisieren in Schritt 3. Optionen anbieten statt nachsichtig sein.
|
||||
5. **Inline-Recherche moeglich, aber nicht Default.** Bei Wissensluecke des Nutzers: anbieten ("Soll ich kurz recherchieren?"). Erst auf Bestaetigung WebSearch nutzen. Ergebnisse als `_(Recherche)_` markieren.
|
||||
</essential_principles>
|
||||
|
||||
## When to Use
|
||||
|
||||
<when_to_use>
|
||||
- Nutzer hat eine **noch nicht strukturierte** Idee und will sie in Form bringen.
|
||||
- Aus Router-Hand-off (Pfad 1 in `klarheit-mit-idea2self/references/routing-table.md`).
|
||||
- Direkter Trigger: "Discovery-Interview", "vage Idee strukturieren", "Idee erfassen", "idea2self-Datei anlegen".
|
||||
</when_to_use>
|
||||
|
||||
## When NOT to Use
|
||||
|
||||
<when_not_to_use>
|
||||
- Es gibt bereits eine `idea2self-<idee>.md` mit ausgefuellter `## Idee` Sektion -> Router review-iterate oder direkter Sub-Skill je nach Iterations-Ziel.
|
||||
- Nutzer will direkt zum Problem-Statement -> `i2s-problem-statement` (wenn Idee bereits klar genug fuer HMW-Formulierung).
|
||||
- Generelles Idee-Brainstorming ohne Validierungsabsicht -> `compound-engineering:ce-brainstorm`.
|
||||
</when_not_to_use>
|
||||
|
||||
## Phases
|
||||
<quick_start>
|
||||
Trigger "Discovery-Interview starten" oder "vage Idee strukturieren", keine Vorbedingung noetig. Entry-Point ist Phase 1 (Orientierung); danach laeuft das 5-Schritt-Interview durch bis Phase 5. Output: eine neue `idea2self-<kurztitel>.md` Datei mit ausgefuellter `## Idee` Sektion. Detaillierte Referenzen siehe Reference-Index unten.
|
||||
</quick_start>
|
||||
|
||||
### Phase 1 — Orientierung
|
||||
<workflow>
|
||||
**Phase 1 — Orientierung**
|
||||
|
||||
**Entry:** Skill aktiviert.
|
||||
|
||||
@@ -43,19 +46,19 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
|
||||
|
||||
**Exit:** Ideen-Typ ist bestaetigt.
|
||||
|
||||
### Phase 2 — Vertiefung (adaptiv)
|
||||
**Phase 2 — Vertiefung (adaptiv)**
|
||||
|
||||
**Entry:** Ideen-Typ bestaetigt.
|
||||
|
||||
**Aktionen:**
|
||||
1. Lade die typ-relevanten Kategorien aus `workflows/discovery.md` Schritt 2 (4 Kategorien: Problem/Motivation, Zielgruppe, Kontext/Ressourcen, Scope/Abgrenzung).
|
||||
2. Stelle pro Kategorie 1-2 Fragen, max 4-6 insgesamt.
|
||||
3. Bei Wissensluecke des Nutzers: Inline-Recherche anbieten (`web_search`).
|
||||
3. Bei Wissensluecke des Nutzers: Inline-Recherche anbieten (`WebSearch`). Web-Tools (`WebSearch`/`WebFetch`) werden NUR auf explizite Nutzer-Bestaetigung und nur fuer eine einzelne Begriffsklaerung aktiviert — fuer volle Recherche an `i2s-recherche` verweisen.
|
||||
4. Pflicht-Frage am Ende von Phase 2: "Was wird bewusst NICHT dazugehoeren?"
|
||||
|
||||
**Exit:** Alle 4 Kategorien beruehrt + Scope-Ausschluss benannt.
|
||||
|
||||
### Phase 3 — Widerspruchspruefung
|
||||
**Phase 3 — Widerspruchspruefung**
|
||||
|
||||
**Entry:** Phase 2 abgeschlossen.
|
||||
|
||||
@@ -66,7 +69,7 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
|
||||
|
||||
**Exit:** Konflikte sind geloest oder als offen markiert.
|
||||
|
||||
### Phase 4 — Bestaetigung
|
||||
**Phase 4 — Bestaetigung**
|
||||
|
||||
**Entry:** Phase 3 abgeschlossen.
|
||||
|
||||
@@ -76,7 +79,7 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
|
||||
|
||||
**Exit:** Nutzer bestaetigt das zusammengefasste Verstaendnis.
|
||||
|
||||
### Phase 5 — Datei-Bootstrap
|
||||
**Phase 5 — Datei-Bootstrap**
|
||||
|
||||
**Entry:** Bestaetigung erhalten.
|
||||
|
||||
@@ -89,25 +92,23 @@ Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Sch
|
||||
6. Datei dem Nutzer zeigen + Hand-off-Hinweis: "Naechster Schritt: Problem-Statement. Trigger: 'Problem-Statement erstellen' fuer `i2s-problem-statement`."
|
||||
|
||||
**Exit:** Datei existiert auf Disk, `## Idee` ist ausgefuellt, Hand-off ausgesprochen.
|
||||
</workflow>
|
||||
|
||||
## Quick Reference
|
||||
|
||||
<reference_guides>
|
||||
Kommunikation: `references/kommunikationsregeln.md` (Tonalitaet, Marker, Steuerbefehle).
|
||||
Datei-Format: `references/idee-format.md` (Schema fuer `## Idee` Sektion).
|
||||
Datei-Skelett: `templates/idea2self-vorlage.md`.
|
||||
Workflow-Detail (alle 5 Schritte): `workflows/discovery.md`.
|
||||
|
||||
## Reference Index
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `workflows/discovery.md` | Vollstaendiger 5-Schritt-Interview-Ablauf mit Fragen |
|
||||
| `references/kommunikationsregeln.md` | Tonalitaet, Marker (Vorschlag/Annahme), Steuerbefehle |
|
||||
| `references/idee-format.md` | Markdown-Schema fuer die `## Idee` Sektion |
|
||||
| `templates/idea2self-vorlage.md` | Skelett der idea2self-Datei (wird in Phase 5 angelegt) |
|
||||
</reference_guides>
|
||||
|
||||
## Success Criteria
|
||||
|
||||
<success_criteria>
|
||||
- [ ] Ideen-Typ ist klassifiziert + bestaetigt.
|
||||
- [ ] Idee ist in 1-2 Saetzen beschreibbar.
|
||||
- [ ] Zielgruppe ist benannt (vage erlaubt, aber konkrete Person als Anker).
|
||||
@@ -117,3 +118,4 @@ Workflow-Detail (alle 5 Schritte): `workflows/discovery.md`.
|
||||
- [ ] Innere Widersprueche sind benannt oder geloest.
|
||||
- [ ] `idea2self-<kurztitel>.md` existiert mit `## Idee` Sektion + `## Changelog`.
|
||||
- [ ] Hand-off zu `i2s-problem-statement` ist ausgesprochen.
|
||||
</success_criteria>
|
||||
|
||||
Reference in New Issue
Block a user