[workshop-sim] Repair: Fix Step 5 lock-file state gap and add retrieval practice

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

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
60/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
github-actions
領域
documentation

調査の方向性

05-agentic-workflows-intro.md の演習 1 から始めてください。該当箇所は 53 行目付近で、リポジトリ内の任意の .lock.yml ファイルを開くようページが学習者に求めている部分です。この手順を、単独で完結する注釈付きスニペットに置き換え、予測してから確認する演習、2 つのファイル構成に関する短い理解度チェック、そして lock ファイルがない学習者向けの復旧メモを追加してください。演習 1 が学習者自身が作成していないファイルに依存しなくなり、ページの既存の練習課題とチェックポイントが維持されていれば完了です。

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

説明

feedback simulation workshop
Problem

05-agentic-intro has 18.9% conditional dropout (36,945 at-risk runs). The failures are agentic-concept-gap (4,772) and deployment-capability-gap (2,194). 05-agentic-workflows-intro.md:53 asks learners to open "any .lock.yml file in your repo" before any workflow exists, so the activity may have nothing to open. The page's active_learning score is 2.4.

Proposed change

Replace Activity 1 with a self-contained annotated .lock.yml snippet to inspect, plus a prediction-then-check exercise. Add one short knowledge check on the two-file structure that is revealed after the learner answers. Add a recovery note for learners who have no .lock.yml yet.

Failure mode

Learning barrier. Fix it with scaffolding and practice, not by removing concepts.

Quantitative guardrail
  • Current overall_score: 5.43. Weakest dimensions: active_learning 2.4 and checkpoint_quality 0.0.
  • Learning KPI inputs: active_learning 2.4, checkpoint_quality 0.0, scaffolding 5.0 (index 2.22).
  • Adding an inspectable artifact and a retrieval check increases practice and scaffolding, so all three should hold or rise.
Acceptance criteria
  • Shared curriculum quantitative assessment overall_score for 05-agentic-workflows-intro.md 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, not removed.
  • Activity 1 no longer depends on a file the learner has not yet created.
Suggested owner

copilot coding agent

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

  • expires on Nov 3, 2026, 7:07 AM UTC
主要言語
JavaScript
スター
56
フォーク
40
平均マージ
2日 14時間
マージ済み PR(30日)
13

環境構築

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 を短くまとめたダイジェスト。