[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)

Offen Anfängerfreundlich
#5,973 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
68/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
github-actions, markdown, yaml
Bereich
documentation

Rechercherichtung

Beginne mit dem Lesen von 05-agentic-workflows-intro.md, insbesondere Aktivität 1 in den Zeilen 53–58 und den Verweisen auf Lock-Dateien in Schritt 7. Ersetze Aktivität 1 durch einen verlinkten oder inline eingebetteten Beispielauszug aus .lock.yml, sodass es ohne vorherigen Zustand funktioniert, und füge dann nach den drei Schlüsselbegriffen einen Checkpoint sowie einen „stuck?“-Hinweis für die Zwei-Datei-Vorhersage hinzu. Verifiziere, dass die gemeinsame Curriculum-Bewertung overall_score und der Lern-KPI gleich bleiben oder sich verbessern, und bestätige, dass Aktivität 1 keine zuvor erstellten Workflow-Dateien benötigt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

feedback simulation workshop
Problem

05-agentic-workflows-intro.md has 18.6% conditional dropout (6,864/36,948): 4,671 agentic-concept-gap, 2,193 deployment-capability-gap. Activity 1 (lines 53–58) tells learners to open "any .lock.yml file in your repo", but no lock file exists before Step 7. The page has no recovery help (troubleshootingSupport 0.06) and a long concept load (trigger, task brief, safe outputs, sandbox, two files).

Proposed change

Replace Activity 1 with a linked sample lock file excerpt (or an inline snippet) so the activity works with no prior state. Add a short intermediate checkpoint after the three key terms and a "stuck?" hint for the two-file prediction.

Failure mode

Learning barrier (with a small state-assumption component).

Quantitative guardrail

Current: overall 5.39, cognitive_load 8.4, active_learning 2.3 (weakest learning dimension), checkpoint_quality 0.0, scaffolding 5.0 (KPI ≈ 2.3). Adding a working hands-on activity and mid-page checkpoint increases active_learning and checkpoint_quality without cutting content.

Acceptance criteria
  • Shared curriculum assessment overall_score for this step stays flat or improves
  • Learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays flat or improves
  • Hands-on practice, checkpoints, and scaffolding are preserved or strengthened
  • Activity 1 can be completed without any previously created workflow files
Suggested owner

copilot coding agent

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~38 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 22, 2026, 11:03 AM UTC
Vorherrschende Sprache
JavaScript
Sterne
61
Forks
43
Ø Merge
10 Std. 38 Min.
Gemergte PRs (30 T.)
12

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

  • Kein Dockerfile und keine Docker-Compose-Datei
  • Keine Pull-Request-Vorlage
  • Kein Beitragsleitfaden

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus githubnext/gh-aw-workshop

Alle Issues in githubnext/gh-aw-workshop

Ähnliche Issues

Weitere Issues zu JavaScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.