[curriculum-eval] side-quest-11-06-anthropic-key.md: cognitive_load — 26 new concepts in a 685-word setup guide

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

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

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

評価

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

調査の方向性

変更するファイルは workshop/side-quest-11-06-anthropic-key.md です。多くの用語がインラインでリンクされている導入段落と、UI や CLI の操作を説明する番号付きの手順から始めてください。導入は 2 文に短くし、各用語のリンクは初出時のみにします。操作は、gh secret set ANTHROPIC_API_KEY のような短いコマンドブロックや、engine: claude というフロントマターの抜粋に置き換えてください。Checkpoint の項目が 5 つのまま残っており、概念の数が約 15 以下で、npx --yes markdownlint-cli2 "**/*.md" が通れば完了です。

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

説明

curriculum documentation quality

File: workshop/side-quest-11-06-anthropic-key.md
Overall Score: 5.37 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 7.2 ≥ 8 (≤ 15 concepts) −0.8 (26 concepts)
active_learning 3.4 ≥ 10 (density ≥ 3) −6.6 (density 1.02)

Root Cause (≤ 2 sentences):
Intro and step text pack dense inline links and terms (engine, secrets, frontmatter, network allowlist, compile) into a short guide. The step-by-step actions have few commands/code blocks relative to prose.

Evidence (quoted from the file):

By default, agentic workflows run on the GitHub Copilot engine. If you prefer to use Claude ...

Learning Science Rationale:
Mayer's coherence and signalling principles: linking every term inline adds extraneous load. Defining a term once, then using plain words, and putting each action in a code block or checklist reduces split attention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-11-06-anthropic-key.md: link each concept only on first use, trim the intro to 2 sentences, convert the UI/CLI actions into short numbered commands or code blocks (e.g. gh secret set ANTHROPIC_API_KEY, the engine: claude frontmatter snippet, gh aw compile), and keep the Checkpoint at 5 items. Target ≤ 15 new concepts. Run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (≈ 8.5 once the rubric detection bug is fixed)

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

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