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

[curriculum-eval] side-quest-17-07-repo-poisoning.md: cognitive_load — 23 new concepts crammed before exercises

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#3,674 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
85/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions
Lĩnh vực
content, documentation

Hướng nghiên cứu

Bắt đầu với workshop/side-quest-17-07-repo-poisoning.md, đặc biệt là phần “How AW Defends Against It” và bốn tiểu mục của phần này. Thêm các bước kiểm tra được yêu cầu cho từng cơ chế phòng vệ, cân nhắc cắt bớt hoặc di chuyển nội dung không thiết yếu, giữ nguyên các mục tiêu học tập và checkpoint hiện có, rồi chạy npx --yes markdownlint-cli2 "**/*.md". Được xem là hoàn tất khi tệp không còn lỗi lint và các mối lo ngại về tải nhận thức cũng như mật độ hoạt động đã được xử lý.

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: workshop/side-quest-17-07-repo-poisoning.md
Overall Score: 5.0 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.7 ≥ activity density 3 (score 10) -7.3
cognitive_load 5.9 ≤ 800 words / ≤ 15 new concepts (score 10) -4.1

Note: the rubric also flags missing_checkpoint, but this is a confirmed tooling bug (see scorecard issue) — the file has a well-formed ## :white_check_mark: Checkpoint with 6 specific checklist items. Dismissed.

Root Cause (≤ 2 sentences):
The page introduces 23 new concepts (permissions blocks, contents: read, safe-outputs: create-pull-request, protected-files, network.allowed-domains, PR routing, path restriction, etc.) across 9 h2 sections in 1,224 words, exceeding the 15-concept cognitive-load ceiling by more than 50%. Two "Exercise" sections ask learners to identify dangerous frontmatter and harden a workflow, but at density 0.82 the surrounding defensive-technique explanations (four distinct YAML configuration patterns) are delivered as dense prose before those exercises, front-loading concepts rather than interleaving practice.

Evidence (quoted from the file):

Repository poisoning is what happens when a misdirected agent with write access commits changes an attacker designed — not changes the workflow author intended.

gh-aw gives you three layers to prevent repository poisoning.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that presenting four distinct configuration mechanisms (read-only permissions, PR routing, path restriction, network allow-listing) as sequential prose paragraphs before any hands-on check overloads working memory, especially when each mechanism carries its own YAML syntax and rationale. Splitting the exposition into smaller worked-example chunks with immediate micro-checks (segmenting principle) would let learners consolidate each defense before the next is introduced, rather than holding all four in memory until the exercises at the bottom of the page.

Improvement Prompt (for an agent):

Edit workshop/side-quest-17-07-repo-poisoning.md to reduce cognitive load and raise activity density. Under "How AW Defends Against It," after each of the four ### subsections (Declare read-only permissions, Route writes through a pull request, Restrict which paths can change, Limit network destinations), insert a short one-line "Quick check" prompt or a 1-item micro-exercise (e.g., a code snippet to fix) tied to that specific defense, instead of leaving both exercises stacked at the end of the page. Consider trimming or moving one of the four defense subsections into a linked follow-up if it is not essential to this side quest's core objective, to bring new-concept count closer to 15-18. Keep the existing checkpoint and learning objectives unchanged. Run npx --yes markdownlint-cli2 "**/*.md" after editing.

Expected Score After Fix: 6.1 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 74.5 AIC · ⌖ 11.9 AIC · ⊞ 9K · ◷

  • expires on Sep 23, 2026, 3:48 AM UTC
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
13 giờ 50 phút
Pull request đã merge (30 ngày)
14

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.