[curriculum-eval] curriculum_assessment.py: checkpoint_quality and scaffolding — regexes miss :shortcode: headings

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#5,297 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 3 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions, markdown, python
Lĩnh vực
tooling

Hướng nghiên cứu

Bắt đầu từ .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py và tìm CHECKPOINT_RE cùng regex Before-You-Start, hai regex này chỉ khớp với emoji viết trực tiếp. Mở rộng cả hai để chấp nhận các shortcode ✅ và 📋, bao gồm cả việc nhận diện bloom 'activity:checkpoint'. Hoàn thành khi workshop/04-github-actions-intro.md đạt checkpoint_quality ≥ 10 và scaffolding 10 trong lần chạy lại trên workshop/.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

curriculum documentation quality

File: .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py
Overall Score: n/a (rubric tooling; corpus mean 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
checkpoint_quality 0.0 (92 of 94 files) ≥ 7.5 ≈ −7.5
scaffolding 5.0 (understated) 10 when present −5

Root Cause (≤ 2 sentences):
CHECKPOINT_RE = r"##\s+✅\s*Checkpoint" and the Before-You-Start regex ##\s+📋\s*Before You Start match literal emoji, but workshop files use :white_check_mark: and :clipboard: shortcodes. Every checkpoint and scaffolding section is therefore reported as missing, which drags down scores and produces false missing_checkpoint findings.

Evidence (quoted from the file):

workshop/04-github-actions-intro.md: ## :white_check_mark: Checkpoint followed by 5 checklist items, and ## :clipboard: Before You Start — yet scored checkpoint_quality: 0.0, scaffolding: 5.0.

Learning Science Rationale:
Valid measurement is a precondition for acting on scores. Formative-assessment research (Black & Wiliam) shows checkpoints support retrieval practice and self-monitoring. A rubric that reports them as absent misdirects authors toward adding content that already exists and hides real gaps.

Improvement Prompt (for an agent):

In .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py, update CHECKPOINT_RE and the has_prereq_section regex so they match both the literal emoji (✅, 📋) and GitHub shortcodes (:white_check_mark:, :clipboard:). Example: r"##\s+(?:✅|:white_check_mark:)\s*Checkpoint". Also update the bloom 'activity:checkpoint' detection that uses CHECKPOINT_RE. Add/adjust tests if present, rerun the assessment on workshop/, and confirm 04-github-actions-intro.md now gets checkpoint_quality ≥ 10 and scaffolding = 10.

Expected Score After Fix: ~7.0 / 10.0 corpus mean (from 6.06)

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

  • expires on Nov 4, 2026, 6:03 AM UTC
Ngôn ngữ chính
JavaScript
Star
58
Fork
40
Merge trung bình
4 ngày 4 giờ
Pull request đã merge (30 ngày)
8

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.