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

[workshop-sim] Improve: Add per-activity checkpoints to agentic workflows intro (05-agentic-workflows-intro.md)

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

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

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

評価

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

調査の方向性

05-agentic-workflows-intro.md を開き、3 つのアクティビティ見出しと、その直下にある解答表示用の <details> ブロックを見つけてください。各ブロックの直後に、1～2 項目の短いチェックポイントを追加します。既存のアクティビティ、2 ファイル構成の図、用語集へのリンクは変更しないでください。その後、ページ末尾のチェックリストに照らして新しいテキストを確認します。各アクティビティに専用のチェックポイントがあり、npx --yes markdownlint-cli2 "**/*.md" が新たなエラーを報告しなければ完了です。

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

説明

feedback simulation workshop

Problem statement

05-agentic-workflows-intro.md has the single highest total failure count in the simulated cohort (7,350 failures across 1,000×46 runs) and the second-highest conditional dropout rate (19.9% among 36,952 at-risk runs), driven by agentic-concept-gap (5,204 failures) and deployment-capability-gap (2,146 failures). The step scores the lowest active_learning (2.4/10) in the entire curriculum despite stacking three distinct activities back-to-back — opening a .lock.yml to find on:, classifying Task A/B as agentic-or-standard, and writing/self-grading a task brief — with only one optional "Still uncertain?" disclosure as mid-page recovery support and no activity-level checkpoint beyond the final checklist.

Proposed change

Give each of the three activities ("Activity 1 — identify the parts", "Activity 2 — agentic or standard?", "Activity 3 — write a task brief") its own short inline checkpoint (a 1-2 item checklist or explicit "did you get this right?" prompt) immediately after its reveal-answer <details> block, instead of deferring all verification to the single end-of-page checklist. Keep all three activities, the two-file-structure diagram, and the glossary side-quest link exactly as they are — the content is appropriately dense for this concept, it just lacks incremental verification.

Failure mode classification: Learning barrier (conceptual density combined with weak intermediate checkpoints, not an access or tooling issue).

Quantitative guardrail

  • Current overall_score: 5.43/10
  • Weakest rubric dimensions: active_learning 2.4/10 (lowest in the entire 30-step corpus), checkpoint_quality 0.0/10 (shared detection gap across all 30 steps — see report)
  • Current learning KPI index for this step: (2.0×2.4 + 2.0×0.0 + 1.5×5.0) / 5.5 = 2.24/10 (active_learning 2.4, checkpoint_quality 0.0, scaffolding 5.0)
  • Adding per-activity checkpoints directly targets active_learning and checkpoint_quality without changing word count materially or removing any existing activity, so overall_score and the learning KPI index should rise, not fall.

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
  • All three existing hands-on activities (Activity 1, 2, 3) and their reveal-answer <details> blocks are preserved, with new checkpoints added rather than content removed
  • Markdown passes npx --yes markdownlint-cli2 "**/*.md" with no new errors

Suggested owner: workshop maintainer
Related to #4367

Generated by 🔬 Workshop Student Simulator · copilot · auto · 163.7 AIC · ⌖ 12.2 AIC · ⊞ 15.1K · ◷

  • expires on Oct 10, 2026, 7:10 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 を短くまとめたダイジェスト。