[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1107 words, 2.4 score for activity density

未关闭 适合新手
#5,436 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 3 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
76/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
markdown
领域
documentation

调研方向

Read workshop/05-agentic-workflows-intro.md and review its word count, activities, Before You Start section, and Checkpoint. Follow the improvement prompt: shorten the key terms, move the specified explanations into a <details> block, and make Activities 2 and 3 checklist driven with concrete outputs. Done when the page is at most 850 words and preserves the required sections; run the provided markdownlint command.

由索引模型根据 Issue 内容生成。

描述

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 ≥ 10 −7.6
cognitive_load ≈ 7.0 (above 800 words) ≥ 9 ≈ −2 (1107 words)

Root Cause (≤ 2 sentences):
This foundational page (three key terms, two-file structure, and three activities) runs 1107 words, ~55% over the 800-word ideal, with activity density only ~0.8 per 100 words. The activities are prose-heavy (classification and brief-writing) with little code or checklist interaction.

Evidence (quoted from the file):

"Before skipping, confirm you already know both of these: You can describe what an Actions workflow trigger does; You have worked with AI agent execution environments in a production or CI/CD context"

Learning Science Rationale:
Mayer's segmenting and signalling principles suggest chunking dense explanations and cueing the learner to the essential elements; Cognitive Load Theory predicts that exceeding ~800 words of mixed explanation and activity taxes working memory in an introductory step. Shorter segments with immediate practice improve retention (the testing effect).

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md. Cut it to ≤ 850 words: shorten "Three key terms" to a three-row table, and move the "Still uncertain?" reveal and extended explanation of the two-file structure into a <details> block. Keep Activity 2 and Activity 3 but turn each into a short checklist-driven task with a concrete expected output (so activity density ≥ 3). Preserve Before You Start and the 6-item Checkpoint. No numbered headings (rename "Activity 2 —" / "Activity 3 —" to descriptive headings). Run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 5.9 / 10.0 with current rubric (≈ 7.7 after the rubric regex fix)

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

  • expires on Nov 8, 2026, 3:03 AM UTC
主要语言
JavaScript
星标
58
派生
40
平均合并
4 天 4 小时
30 天内合并 PR
8

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

githubnext/gh-aw-workshop 的其他 Issue

查看 githubnext/gh-aw-workshop 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。