[curriculum-eval] 05-agentic-workflows-intro.md: cognitive_load — 1107-word core step with low activity density

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

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

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

評価

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

調査の方向性

改善プロンプトに従って workshop/05-agentic-workflows-intro.md を編集します。ページを800語以内に短縮し、先に進むためのブロックを短くし、指定されたセクションを簡潔に保ち、Activities 2 と 3、および既存の checkpoint を残します。npx --yes markdownlint-cli2 "**/*.md" を実行します。ページが語数制限を満たし、lint コマンドが成功すれば作業完了です。

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

説明

curriculum documentation quality

File: workshop/05-agentic-workflows-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load reduced (1107 words) ≤ 800 words −3 pts approx.
active_learning low (flagged) density ≥ 3 below
checkpoint_quality 0.0 reported; a checkpoint exists at line 120 (regex false positive, see rubric issue) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
A core-path page combines three terms, the two-file structure, and three activities, exceeding the word ceiling for a conceptual step. A skip-ahead block at the top also adds text before the first concept.

Evidence (quoted from the file):

"Before skipping, confirm you already know both of these: You can describe what an Actions workflow trigger does; You have worked with AI agent execution environments in a production or CI/CD context"

Learning Science Rationale:
Mayer's segmenting and Sweller's CLT predict that early conceptual steps benefit from shorter chunks. Core path step 05 is the learner's first exposure to agentic concepts, so extraneous load here has outsized effect on later steps.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md to ≤ 800 words: shorten the skip-ahead block to a single sentence, keep "Three key terms" and "The two-file structure" concise, and keep Activity 2 and Activity 3 but tighten surrounding prose. Preserve the existing "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0

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

  • expires on Nov 7, 2026, 7:04 AM UTC
主要言語
JavaScript
スター
58
フォーク
40
平均マージ
4日 4時間
マージ済み PR（30日）
8

環境構築

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