Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sim] Improve: Add a required self-check gate to the agentic-workflows concept page

クローズ 初心者向け
  • 何か問題がありますか？
#4,417 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
62/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
領域
documentation

調査の方向性

変更は 05-agentic-workflows-intro.md に限定されます。Activity 2（Task A/Task B の分類）と Activity 3（task-brief）のセクション、およびチェックポイントの一覧から始め、どの部分が <details> ブロックの中にあるかをメモしてください。答え合わせの前に目に見える記述のプロンプトを追加し、分類が答え合わせの内容と一致したかを問うチェックリスト項目を追加してください。両方の activity の内容はそのまま残します。ページに解答キーの前の必須の想起ステップがあり、チェックポイントが比較を検証していれば完了です。

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

説明

feedback simulation workshop

Problem statement

05-agentic-intro (05-agentic-workflows-intro.md) is the top concept-level blocker in this run: 18.5% conditional dropout among 37,018 at-risk runs (95% MC interval 18.1%–18.9%), with 4,609 failures tagged agentic-concept-gap. The page's self-check activities (Activity 2's Task A/Task B classification, Activity 3's task-brief drafting) are well-designed but sit entirely behind optional-feeling <details> reveal blocks with no required gate — a learner can open every <details> and tick every checkpoint box without ever actually attempting the classification or writing a brief themselves. This matches the page's low active_learning rubric score (2.4/10, the lowest in the corpus alongside 05b-agentic-workflows-security.md).

Proposed change

Add a lightweight, required self-check gate before the checkpoint: ask the learner to write down their Task A/Task B classification and their one-sentence task brief in a visible text field (not inside a <details>) before they are allowed to reveal the answer key, and have the checkpoint explicitly ask "Did your classification match the reveal?" as its own checklist item (rather than just "I made my decision"). This converts a passive reading activity into an active recall-and-compare activity without adding new concepts or word count.

Failure mode classification

Learning barrier — this is a conceptual/scaffolding gap (weak active-learning design), not an access or tooling issue.

Quantitative guardrail

Current scores for 05-agentic-workflows-intro.md:

  • overall_score: 5.43/10
  • Weakest rubric dimensions: active_learning 2.4/10 and checkpoint_quality 0.0/10
  • Learning KPI index inputs: active_learning 2.4/10 · checkpoint_quality 0.0/10 · scaffolding 5.0/10 → index ≈ 2.24/10 (well below the cohort mean of 2.87/10)

Converting optional reveals into a required recall-then-compare step directly targets active_learning (the rubric's activity_density measure counts checklist items and code/exercise blocks, so adding explicit recall checklist items raises this score) without increasing new_concepts or word_count, so cognitive_load and readability should be unaffected. This repair should raise, not lower, the step's overall_score and learning KPI index.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 05-agentic-workflows-intro.md stays flat or improves after the change
  • The step's learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays flat or improves, with active_learning specifically increasing from its current 2.4/10
  • The existing Activity 2 and Activity 3 exercises are preserved (not removed or simplified) — only the required/optional framing changes
  • The updated checkpoint explicitly verifies the learner compared their own answer against the reveal, not just that they viewed it

Suggested owner profile

copilot coding agent (contained content edit to one workshop page, mechanical in nature)
Related to #4415

Generated by 🔬 Workshop Student Simulator · copilot · auto · 199.9 AIC · ⌖ 8.38 AIC · ⊞ 15.1K · ◷

  • expires on Oct 11, 2026, 8:57 AM UTC
主要言語
JavaScript
スター
55
フォーク
36
平均マージ
2日 8時間
マージ済み PR（30日）
17

環境構築

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