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

オープン 初心者向け
#5,973 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
68/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
github-actions, markdown, yaml
領域
documentation

調査の方向性

まず 05-agentic-workflows-intro.md を読み、特に 53–58 行目の Activity 1 と、Step 7 のロックファイルへの参照を確認してください。Activity 1 を、リンクされた、またはインラインの .lock.yml サンプル抜粋に置き換えて、事前状態なしで動作するようにし、その後、3 つの重要語句の後にチェックポイントを追加し、2 ファイル予測に対する「stuck?」ヒントを追加してください。共有カリキュラム評価 overall_score と学習 KPI が横ばいまたは改善していることを検証し、Activity 1 に事前に作成された workflow ファイルが必要ないことを確認してください。

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
JavaScript
スター
61
フォーク
43
平均マージ
10時間 38分
マージ済み PR(30日)
12

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。