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,41 +6,45 @@ metadata:
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# i2s-recherche — Problemraum-Recherche
|
||||
|
||||
<objective>
|
||||
Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `## Problem-Statement` und `## Persona`. Bereitet zugleich Interviews vor (Orte + Proxy-Gruppen + Ansprache). Triggert Rueckwaerts-Updates auf PS und Persona, wenn Recherche das nahelegt.
|
||||
</objective>
|
||||
|
||||
## Essential Principles
|
||||
<essential_principles>
|
||||
|
||||
1. **Quellenbasiert, nicht spekulativ.** Jede Behauptung im Recherche-Report braucht mindestens **eine** Quelle, zentrale Behauptungen **zwei unabhaengige**. Primaerquellen vor Sekundaerquellen.
|
||||
2. **Recherche schaerft, nicht ersetzt.** Der Skill ersetzt keine Interviews. Recherche ist Vorbereitung — Interviews bringen den ground truth (gehoert in `i2s-experiment-card`).
|
||||
3. **Rueckwaerts-Updates sind erlaubt + erwartet.** Wenn die Recherche zeigt, dass PS oder Persona falsch liegen: v0.2-Vorschlaege sind Pflicht, nicht optional. Aenderung nur nach Nutzer-Bestaetigung.
|
||||
4. **Stadt-Frage frueh.** In welcher Stadt finden Interviews statt? Steuert Orts-Suche + lokale Proxy-Gruppen. Ohne diese Info bleibt Interview-Vorbereitung abstrakt.
|
||||
5. **Quellen-Aktualitaet.** Marktdaten max 2 Jahre alt. Verhaltens-Studien max 5 Jahre. Aelter -> als `_(Quelle gealtert)_` markieren.
|
||||
</essential_principles>
|
||||
|
||||
## When to Use
|
||||
<when_to_use>
|
||||
|
||||
- `## Problem-Statement` UND `## Persona` existieren, `## Recherche-Report` fehlt oder ist veraltet.
|
||||
- Aus Router-Hand-off (Pfad 4) oder direkter Trigger ("Problemraum recherchieren").
|
||||
- Nach Interview-Runde: Re-Recherche mit neuen Hypothesen (v0.3).
|
||||
</when_to_use>
|
||||
|
||||
## When NOT to Use
|
||||
<when_not_to_use>
|
||||
|
||||
- `## Persona` fehlt -> erst `i2s-persona`.
|
||||
- Allgemeine Web-Recherche ohne Idea2Self-Kontext -> `compound-engineering:ce-web-researcher`.
|
||||
- Wettbewerbs-Deep-Dive (Pricing, Feature-Vergleich) -> noch nicht modelliert; fuer Idea2Self bewusst out-of-scope (Status quo == Wettbewerb).
|
||||
</when_not_to_use>
|
||||
|
||||
## Precondition Check
|
||||
<precondition_check>
|
||||
|
||||
**Vor Phase 1:**
|
||||
1. idea2self-Datei laden.
|
||||
2. Auf `^## Problem-Statement` UND `^## Persona` matchen, beide > 100 Zeichen Inhalt.
|
||||
3. Wenn PS fehlt -> abbrechen, Hand-off `i2s-problem-statement`.
|
||||
4. Wenn Persona fehlt -> abbrechen, Hand-off `i2s-persona`.
|
||||
</precondition_check>
|
||||
|
||||
## Phases
|
||||
<workflow>
|
||||
|
||||
### Phase 1 — Kontext laden + Recherche-Fragen ableiten
|
||||
**Phase 1 — Kontext laden + Recherche-Fragen ableiten**
|
||||
|
||||
**Entry:** Vorbedingung erfuellt.
|
||||
|
||||
@@ -53,7 +57,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
|
||||
**Exit:** 4-6 Fragen liegen vor.
|
||||
|
||||
### Phase 2 — Fragen zeigen + Stadt-Frage
|
||||
**Phase 2 — Fragen zeigen + Stadt-Frage**
|
||||
|
||||
**Entry:** Fragen liegen vor.
|
||||
|
||||
@@ -64,7 +68,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
|
||||
**Exit:** Fragen final, Stadt bekannt.
|
||||
|
||||
### Phase 3 — Recherche durchfuehren
|
||||
**Phase 3 — Recherche durchfuehren**
|
||||
|
||||
**Entry:** Phase 2 abgeschlossen.
|
||||
|
||||
@@ -77,7 +81,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
|
||||
**Exit:** Alle Fragen haben quellengestuetzte Antworten oder explizit "Keine belastbaren Quellen gefunden".
|
||||
|
||||
### Phase 4 — Report aufbereiten
|
||||
**Phase 4 — Report aufbereiten**
|
||||
|
||||
**Entry:** Phase 3 abgeschlossen.
|
||||
|
||||
@@ -91,7 +95,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
|
||||
**Exit:** Strukturierter Report-Entwurf liegt vor.
|
||||
|
||||
### Phase 5 — v0.2-Vorschlaege ableiten
|
||||
**Phase 5 — v0.2-Vorschlaege ableiten**
|
||||
|
||||
**Entry:** Phase 4 abgeschlossen.
|
||||
|
||||
@@ -103,7 +107,7 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
|
||||
**Exit:** v0.2-Updates sind freigegeben oder als offen vermerkt.
|
||||
|
||||
### Phase 6 — Export
|
||||
**Phase 6 — Export**
|
||||
|
||||
**Entry:** Phase 5 abgeschlossen.
|
||||
|
||||
@@ -114,15 +118,13 @@ Schritt 4 im Idea2Self-Prozess. Quellenbasierte Validierung der Annahmen aus `##
|
||||
4. Hand-off: "Recherche abgeschlossen. Naechster Schritt: Experiment-Card. Trigger: 'Experiment planen' fuer `i2s-experiment-card`. Oder 'Weiter'."
|
||||
|
||||
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
|
||||
</workflow>
|
||||
|
||||
## Quick Reference
|
||||
<quick_start>
|
||||
Trigger "Problemraum recherchieren". Vorbedingung: idea2self-Datei mit `## Problem-Statement` UND `## Persona`. Output: `## Recherche-Report` Sektion plus optionale v0.2-Updates auf PS/Persona nach Bestaetigung. Referenz-Guides siehe Reference-Index unten.
|
||||
</quick_start>
|
||||
|
||||
Kommunikation: `references/kommunikationsregeln.md`.
|
||||
Recherche-Qualitaets-Regeln: `references/recherche-regeln.md`.
|
||||
Format-Schema: `references/recherche-report-format.md`.
|
||||
Workflow-Detail: `workflows/recherche.md`.
|
||||
|
||||
## Reference Index
|
||||
<reference_guides>
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
@@ -130,8 +132,9 @@ Workflow-Detail: `workflows/recherche.md`.
|
||||
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated) |
|
||||
| `references/recherche-regeln.md` | Quellen-Qualitaet, Aktualitaet, Widerspruchs-Handling, einfache vs tiefe Recherche (curated) |
|
||||
| `references/recherche-report-format.md` | Markdown-Schema fuer `## Recherche-Report` |
|
||||
</reference_guides>
|
||||
|
||||
## Success Criteria
|
||||
<success_criteria>
|
||||
|
||||
- [ ] 4-6 Recherche-Fragen sind beantwortet (oder explizit als "keine belastbaren Quellen" markiert).
|
||||
- [ ] Jede zentrale Behauptung hat mindestens 2 unabhaengige Quellen, Primaerquellen bevorzugt.
|
||||
@@ -141,3 +144,4 @@ Workflow-Detail: `workflows/recherche.md`.
|
||||
- [ ] v0.2-Vorschlaege fuer PS und Persona sind formuliert + vom Nutzer entschieden.
|
||||
- [ ] idea2self-Datei enthaelt `## Recherche-Report`. PS und Persona ggf. auf v0.2 aktualisiert mit `_(Update aus Recherche)_` Marker.
|
||||
- [ ] Hand-off zu `i2s-experiment-card` ist ausgesprochen.
|
||||
</success_criteria>
|
||||
|
||||
Reference in New Issue
Block a user