abertanha/md-to-wiki-docs-skills

md-to-wiki — Dünner Router (Phase 2)

Verwandle Markdown-Spezifikationsdateien in Dokumentationsseiten.

Auslöser: „Wiki erstellen", „Dokumentation generieren", „Spezifikationen veröffentlichen", „Seite erstellen", „Wiki aus Markdown", „Diagramm zeichnen", „Flussdiagramm", „Architekturdiagramm", „Zustandsdiagramm", „Sequenzdiagramm"

Phasen-Router

Analysiere die Benutzeranfrage, um den passenden Pfad zu bestimmen:

lower=$(echo "$1" | tr '[:upper:]' '[:lower:]')
case "$lower" in
  *"not sure"*|*"help"*|*"recommend"*)     ROUTE="onboarding" ;;
  *"html"*|*"site"*|*"mkdocs"*|*"material"*)  ROUTE="mkdocs" ;;
  *"swagger"*|*"openapi"*|*"api"*)          ROUTE="swagger" ;;
  *"github wiki"*|*"wiki tab"*)             ROUTE="github-wiki" ;;
  *"dokuwiki"*|*"doku"*)                    ROUTE="dokuwiki" ;;
  *"pdf"*|*"print"*|*"book"*)               ROUTE="pdf" ;;
  *"reference"*|*"issue"*|*"pr"*|*"pull"*)  ROUTE="references" ;;
  *"deploy"*|*"publish"*|*"go live"*)       ROUTE="deploy" ;;
  *)                                          ROUTE="onboarding" ;;
esac

Starte dann den passenden Agenten:

Route	Agent	Beschreibung
onboarding	agents/onboarding.md	Benutzer befragen, Betriebssystem erkennen, SKILL_DIR einrichten
mkdocs	agents/format-mkdocs.md	MkDocs-Material-Seite generieren
swagger	agents/format-swagger.md	OpenAPI 3.0 + Swagger UI generieren
github-wiki	agents/format-github-wiki.md	In GitHub-Wiki veröffentlichen
dokuwiki	agents/format-dokuwiki.md	In DokuWiki-Format konvertieren
pdf	agents/format-pdf.md	PDF via Pandoc generieren
references	agents/references.md	Dokumentation mit GitHub-Issue/PR-Referenzen anreichern
deploy	agents/deploy.md	Generierte Dokumentation bereitstellen

Ausführungsablauf

1. Onboarding → Fragen stellen: Projektname, Quellverzeichnisse, Zielgruppe (Entwickler/Stakeholder/Allgemein), gewünschtes Format. Betriebssystem einmal erkennen, SKILL_DIR, SCRIPT_EXT, SCRIPT_RUNNER speichern.
2. Formatgenerierung → Passenden Format-Agenten laden. Companion-Skripte aus scripts/ mit $SCRIPT_RUNNER verwenden.
3. Referenzen → Falls gewünscht, references.md laden.
4. Deployment → Nach der Generierung deploy.md laden, um Hosting anzubieten.

Globale Variablen (werden während des Onboardings einmal gesetzt)

• SKILL_DIR — aufgelöster Pfad zu diesem Skill-Ordner
• SCRIPT_EXT — .sh oder .ps1
• SCRIPT_RUNNER — "" oder "powershell -File"
• OS_TYPE — unix oder windows
• PROJECT_NAME — vom Benutzer
• SOURCES — Pfade zu Spezifikationsdateien
• AUDIENCE — developer, stakeholder oder general

Companion-Skripte

Alle akzeptieren Positionsargumente identisch in .sh und .ps1:

Skript	Zweck
discover-sources	Durchsucht Verzeichnisse nach Spezifikations-/Projekt-/Codebasis-/Quick-Dateien
generate-mkdocs	Erstellt vollständige mkdocs.yml + Seitenstruktur
generate-index	Baut zielgruppengerechte Landingpage
to-dokuwiki	Konvertiert Markdown → DokuWiki-Syntax
to-pdf	Verkettet und konvertiert via pandoc zu PDF
fetch-issues	Cached GitHub-Issue/PR-Metadaten

Multi-Verzeichnis-Eingabe

Mehrere Quellverzeichnisse vor der Ausführung in merged-specs/ zusammenführen:

mkdir -p merged-specs && cp -r .specs/* docs/* merged-specs/

Teilen

Kopiere md-to-wiki/ in den Ordner .config/opencode/skills/ oder .opencode/skills/ eines Kollegen. Abhängigkeiten variieren je nach Format.