Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[workshop-sim] Repair: Fix checkpoint-quality regex in curriculum_assessment.py to recognize :white_check_mark: shortcode headings

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,249 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 1 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
78/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ệ
markdown, python
Lĩnh vực
testing, tooling

Hướng nghiên cứu

Bắt đầu với .github/skills/curriculum-quantitative-assessment/curriculum_assessment.py và kiểm tra CHECKPOINT_RE cùng các bài kiểm thử của score_checkpoint_quality(). Chạy quá trình đánh giá trên các tệp workshop và xác nhận rằng cả tiêu đề có ✅ theo nghĩa đen lẫn tiêu đề có :white_check_mark: đều được phát hiện. Hoàn tất khi các checkpoint được chấm điểm dựa trên nội dung danh sách kiểm tra, Learning KPI của nhóm học cải thiện và không có nội dung workshop nào thay đổi.

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

Mô tả

feedback simulation workshop
Problem statement

.github/skills/curriculum-quantitative-assessment/curriculum_assessment.py scores checkpoint_quality as 0.0/10 for all 30 main workshop steps, even though every step (confirmed on 04-github-actions-intro.md, 07-your-first-workflow.md, 07d-confirm-model-access.md, 08-run-your-workflow.md, and others) ends with a properly formatted ## :white_check_mark: Checkpoint section containing a markdown checklist, exactly as required by AGENTS.md. The detection regex CHECKPOINT_RE = re.compile(r"##\s+✅\s*Checkpoint", re.IGNORECASE) only matches the literal unicode ✅ emoji character, but the workshop's actual convention (and AGENTS.md's own documented style) uses the GitHub Markdown shortcode :white_check_mark:. This silently zeroes out one-third of the weight in the Learning KPI index (checkpoint_quality carries a 2.0 weight alongside active_learning) for every single page in the corpus, masking genuine scaffolding and making the Learning KPI index (currently 2.87/10) artificially pessimistic.

Proposed change

Update CHECKPOINT_RE to also match the :white_check_mark: shortcode form, e.g.:

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

Re-run the assessment script against all workshop files and confirm has_checkpoint becomes True and checkpoint_quality is scored on its actual content-quality criteria (not zeroed) for every page with a real checkpoint section.

Failure mode classification

Learning barrier (measurement defect) — this is not a dropout-causing problem for learners, but it is a content-quality measurement gap that misrepresents the curriculum's actual scaffolding quality and would misdirect future repair priorities if left uncorrected.

Quantitative guardrail

Current cohort-wide values: checkpoint_quality mean 0.0/10 across all 30 steps (every step affected identically), Learning KPI index (2.0×4.15 + 2.0×0.0 + 1.5×5.0)/5.5 ≈ 2.87. After the regex fix, checkpoint_quality should rise from its artificial floor to reflect each step's actual checklist quality (item count, specificity, actionability per score_checkpoint_quality), and the Learning KPI index should rise correspondingly — this is a pure correction, not a content change, so overall_score per step should only increase or stay flat, never decrease, since no step currently benefits from the broken regex.

Acceptance criteria
  • The shared curriculum quantitative assessment overall_score for every step with an existing :white_check_mark: Checkpoint heading stays flat or improves after the regex fix
  • The cohort-wide Learning KPI index ((2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5) improves measurably once checkpoint_quality is no longer artificially zeroed
  • No existing checklist items, checkpoints, or scaffolding content are touched — this is a scoring-tool fix only, not a workshop content change
  • score_checkpoint_quality() unit tests (new or existing) confirm both the unicode ✅ and :white_check_mark: shortcode forms are detected
Suggested owner

copilot coding agent (small, well-scoped regex fix with an existing test harness in curriculum_assessment.py)
Related to #4247

Generated by 🔬 Workshop Student Simulator · copilot · auto · 246.5 AIC · ⌖ 8.13 AIC · ⊞ 15.1K · ◷

  • expires on Oct 7, 2026, 9:06 AM UTC
Ngôn ngữ chính
JavaScript
Star
52
Fork
26
Merge trung bình
11 giờ 32 phút
Pull request đã merge (30 ngày)
22

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.