[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1536-word glossary, lowest activity density

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

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

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

評価

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

調査の方向性

まず workshop/side-quest-01-02-environment-reference.md から始め、side-quest-11-06 から #claude などのアンカーへの受信リンクを確認してください。用語集の表を正式な参照元として維持し、「Before You Start」と「Checkpoint」の各セクションを、検証可能な項目を少なくとも4つ含めて残してください。また、内容の重複を減らしながら「Verify-your-tools」のbashブロックを保持してください。ページが900語以下になり、npx --yes markdownlint-cli2 "**/*.md" が成功すれば完了です。

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

説明

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.79 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≤ 800 words, ≤ 15 concepts (actual 1536 words, 19 concepts) −4.7
active_learning 2.4 density ≥ 3 (actual 0.72) −7.6
checkpoint_quality 0.0 (false positive: checkpoint exists; see rubric issue) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
The page is the longest in the corpus (about 2× the 707-word median) because it holds a glossary table, a "Conceptual screenshots" section and seven per-tool subsections that largely repeat the table. Only 4 code blocks exist for 1536 words.

Evidence (quoted from the file):

This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify.

Learning Science Rationale:
Sweller's Cognitive Load Theory and Mayer's redundancy principle predict that presenting the same information twice (table plus per-tool prose) adds extraneous load without improving learning. Reference material should be scannable and chunked, with verification tasks kept short.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 900 words: keep the glossary table as the single source of truth, merge or remove per-tool subsections (GitHub CLI, gh-aw, Copilot CLI, Copilot app, Claude, OpenAI Codex) that repeat it, and keep only unique facts. Retain the ":clipboard: Before You Start" section and the ":white_check_mark: Checkpoint" with ≥ 4 specific verifiable items. Keep the Verify-your-tools bash block. Preserve inbound anchors such as #claude (linked from side-quest-11-06) by keeping headings or updating links. No numbered headings; run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0 (≈ 8.0 once the checkpoint regex is fixed)

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

  • expires on Nov 20, 2026, 8:04 AM UTC
主要言語
JavaScript
スター
61
フォーク
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 を短くまとめたダイジェスト。