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] 05-agentic-workflows-intro.md: active_learning — predict-then-reveal pattern missing for key-terms table

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#3,676 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ó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
88/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, markdown
Lĩnh vực
content, documentation

Hướng nghiên cứu

Chỉnh sửa workshop/05-agentic-workflows-intro.md. Đọc prompt predict-then-reveal hiện có trước “The two-file structure” và bảng “Three key terms” ở gần đó, sau đó thêm một prompt tương đương trước bảng. Chạy npx --yes markdownlint-cli2 "**/*.md"; hoàn tất khi prompt mới đã có, nhất quán với các hoạt động và checkpoint của trang, và lint chạy qua.

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/05-agentic-workflows-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.4 ≥ activity density 3 (score 10) -7.6
cognitive_load 8.5 ≤ 800 words / ≤ 15 new concepts (score 10) -1.5

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 plus a collapsible self-test. Dismissed.

Root Cause (≤ 2 sentences):
This page is the conceptual introduction to agentic workflows (1,107 words, 15 new concepts — near the ideal ceiling) but has only 0.72 activity density: two conceptual diagrams and three named "Activity" sections are described, yet the ratio of code blocks + checklist items to word count is low because most of the content is narrative explanation of the trigger/task-brief/safe-outputs model. The three labeled "Activity" sections (predict-the-answer, classify, write) are good active-learning design, but they're spread thin across a long conceptual narrative, diluting density.

Evidence (quoted from the file):

An Agentic Workflow is a plain-English task brief that an AI agent executes inside GitHub Actions. You write what you want — "summarize open issues and post a daily digest" — and the agent reads your repo, calls tools, and posts the output automatically.

Learning Science Rationale:
Mayer's multimedia principle on generative activity indicates that pairing conceptual diagrams with an explicit retrieval prompt increases retention over passive diagram viewing alone. Here, "The two-file structure" section does ask learners to predict which file GitHub Actions actually runs before showing the diagram — a good technique — but this pattern is not repeated for the "Three key terms" table, missing a low-cost opportunity to convert more of the page's prose into active recall.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md to raise activity density by adding one short predict-then-reveal prompt before the "Three key terms" table, similar to the existing "write your prediction" pattern used before "The two-file structure" diagram (e.g., "Before reading the table below, guess: which of trigger, task brief, or safe outputs controls how the workflow writes back to GitHub?"). Keep this consistent with the page's existing three "Activity" sections and its checkpoint. Run npx --yes markdownlint-cli2 "**/*.md" after editing.

Expected Score After Fix: 6.0 / 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
55
Fork
36
Merge trung bình
2 ngày 8 giờ
Pull request đã merge (30 ngày)
17

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.