[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1124 words with density 0.7 on a core-path step

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

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

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

評価

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

調査の方向性

workshop/05-agentic-workflows-intro.mdを読み、先に進むためのゲート、「Three key terms」、「The two-file structure」、および3つのアクティビティを見つけてください。ページを850語以内に短縮し、説明的な段落を少なくとも2つ、コードブロックまたはコマンドを含む実践的な手順に変えてください。指定されたセクションを維持し、番号付き見出しは避けてください。npx --yes markdownlint-cli2 "**/*.md"を実行し、チェックに合格することを確認してください。

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

説明

curriculum documentation quality

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

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.3 ≥ 10 (density ≥ 3) −7.7
cognitive_load 8.4 ≥ 9 (≤ 800 words) −0.6 (1124 words)

(checkpoint_quality 0.0 and scaffolding 5.0 are rubric false positives.)

Root Cause (≤ 2 sentences):
This core-path concept step is ~40% over the word ideal, with three activities mostly prose-based and few code blocks. It also opens with a skip-ahead gate whose bullet criteria add words before the learner reaches content.

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:
Active-learning research (Freeman et al.) and Mayer's coherence principle suggest removing text that does not directly support the learning goal and replacing it with doing. Converting descriptive passages into short compile/inspect tasks raises engagement without extending the page.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md. Trim it to ≤ 850 words by shortening the skip-ahead gate to one sentence and condensing "Three key terms" and "The two-file structure". Convert at least two explanatory paragraphs into hands-on steps with a code block or command each (for example viewing a .md frontmatter and its compiled .lock.yml). Keep the Before You Start section, the three activities, and the :white_check_mark: Checkpoint. Do not number headings. Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.3 / 10.0 with the current rubric.

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

  • expires on Nov 17, 2026, 3:38 AM UTC
主要言語
JavaScript
スター
62
フォーク
43
平均マージ
11時間 26分
マージ済み 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 を短くまとめたダイジェスト。