[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts for first-time Actions learners

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

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

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

評価

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

調査の方向性

workshop/04-github-actions-intro.md から始め、## Quick Refresher セクションと、138行目付近のCheckpointに注目してください。Issueによると、そこではtrigger、job、runner、action、stepについて問われています。規約についてはAGENTS.mdを読んでください。完了条件は、Quick Refresherがこの5つの用語だけを扱い、残りの詳細が1つの折りたたまれた<details>ブロックにまとめられ、ラベル付けの演習とCheckpointは変更されず、npx --yes markdownlint-cli2 "**/*.md"が成功することです。

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

説明

curriculum documentation quality

File: workshop/04-github-actions-intro.md
Overall Score: 5.39 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.8 ≤ 15 concepts (actual 28) −3.2
active_learning 3.9 density ≥ 3 (met; 3.9 is the scaled score) n/a

(missing_checkpoint is a rubric artefact: a 5-item Checkpoint exists at line 138. See the companion rubric issue.)

Root Cause (≤ 2 sentences):
This is an early core-path step, so it is a learner's first contact with Actions vocabulary (trigger, job, runner, action, step, YAML keys), giving 28 new concepts in 766 words. Novices carry the highest intrinsic load here.

Evidence (quoted from the file):

## Quick Refresher / ## Why This Matters for Agentic Workflows / ## Label a sample workflow / ## Try it: Explore a real workflow

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that novices handle about 4–7 new elements at once. Mayer's pre-training principle suggests introducing the five core terms first, then adding detail only when needed.

Improvement Prompt (for an agent):

Edit workshop/04-github-actions-intro.md to reduce new concepts from 28 to ≤ 15. Restrict the Quick Refresher to the five terms the Checkpoint asks about (trigger, job, runner, action, step). Move anything else into one collapsed <details> block. Keep the labeling activity and the Checkpoint. Follow AGENTS.md conventions and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~41 AIC · ⌖ ~2 AIC · ⊞ 5K · ◷

  • expires on Nov 14, 2026, 3:32 AM UTC
主要言語
JavaScript
スター
62
フォーク
43
平均マージ
1日 5時間
マージ済み PR(30日)
9

環境構築

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