[curriculum-eval] curriculum_assessment.py: checkpoint_quality — regex misses :white_check_mark: shortcode, scoring 93/95 pages as missing checkpo

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

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
85/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
python
領域
tooling

調査の方向性

まず .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py を開き、10行目の CHECKPOINT_RE と、204行目付近の scaffolding 用正規表現を確認します。各パターンを拡張し、絵文字に加えて :white_check_mark: と :clipboard: のショートコードも受け入れるようにしてください。ファイル内の他の絵文字用正規表現も確認します。両方の形式に対するユニットテストを追加し、その後 workshop/ に対して評価を再実行して、workshop/04-github-actions-intro.md で has_checkpoint が true になることを確認してください。

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

説明

curriculum documentation quality

File: .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py
Overall Score: corpus mean 6.06 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 on 93/95 learning pages present, ≥ 4 items → 10 −10
scaffolding 5.0 on most pages "Before You Start" present → 10 −5

Root Cause (≤ 2 sentences):
CHECKPOINT_RE (line 10) matches the literal ✅ character and the scaffolding check (line 204) matches the literal 📋. Workshop pages write ## :white_check_mark: Checkpoint and ## :clipboard: Before You Start, so both checks fail on nearly every page.

Evidence (quoted from the file):

CHECKPOINT_RE = re.compile(r"##\s+✅\s*Checkpoint", re.IGNORECASE)

Pages such as workshop/04-github-actions-intro.md (line 138) contain ## :white_check_mark: Checkpoint with 5 checklist items, yet the rubric reports has_checkpoint: false and checkpoint_quality: 0.0. workshop/side-quest-01-02-environment-reference.md has both a Checkpoint and a :clipboard: Before You Start section, but is reported as missing both. The lowest-ranked pages in the scorecard are therefore mostly ranked by this false negative.

Learning Science Rationale:
Valid measurement is a precondition for acting on rubric results. Cognitive Load Theory and formative-assessment research both favour checkpoints, so a rubric that scores them as absent sends authors toward redundant "fixes" and masks real weaknesses such as concept overload. A score driven mostly by a regex mismatch cannot be used to prioritise curriculum work.

Improvement Prompt (for an agent):

In .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, update CHECKPOINT_RE to match both the emoji and shortcode forms, e.g. r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint". Update the scaffolding regex near line 204 to match both "📋" and ":clipboard:" before "Before You Start", and also check other emoji-based regexes in the file (e.g. :dart:, :pencil2:) for the same problem. Add unit tests covering both forms. Re-run the assessment against workshop/ and confirm that has_checkpoint is true for pages with a checkpoint section, then record the new corpus mean.

Expected Score After Fix: corpus mean ≈ 7.5+ / 10.0, with real findings (long, concept-heavy pages) surfacing.

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

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