[workshop-sim] Improve: Add worked example and recovery guidance to Step 05 (agentic workflows intro)

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

从 workshop/05-agentic-workflows-intro.md 开始,检查 Activities 2 和 3、它们的跳过条件以及现有检查点。在 Activity 2 之前添加一个详细示例,对比智能体式与标准方式;在每个 Activity 下添加恢复指导,并为每个关键术语添加一个检查点,同时保留所有活动。满足验收标准且 Markdown lint 通过后即完成。

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

描述

feedback simulation workshop
Problem statement

workshop/05-agentic-workflows-intro.md loses 18.8% of at-risk runs (6,931 of 36,960): 4,766 agentic-concept-gap and 2,165 deployment-capability-gap. It has the lowest active_learning score (2.3) and relies on a skip gate with no recovery path for learners who struggle with Activities 2 and 3.

Proposed change

Add one fully worked example of the agentic-vs-standard classification before Activity 2, a short "if you got this wrong" explanation under each activity, and a checkpoint item per key term. Keep all activities.

Failure mode

Learning barrier (conceptual density, weak checkpoint).

Quantitative guardrail
  • overall_score: 5.39
  • Weakest dimensions: checkpoint_quality 0.0, active_learning 2.3, scaffolding 5.0
  • Step learning KPI index: (2.0×2.3 + 2.0×0.0 + 1.5×5.0)/5.5 = 2.20
  • Worked example and per-activity feedback strengthen scaffolding and active_learning; no practice is removed.
Acceptance criteria
  • Shared curriculum assessment overall_score for this step stays flat or improves (≥ 5.39)
  • Step learning KPI index stays flat or improves (≥ 2.20)
  • Hands-on practice, checkpoints and scaffolding are preserved or strengthened, not removed
  • Markdown lint passes
Suggested owner

workshop maintainer
Related to #5594

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~41 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 12, 2026, 11:05 AM UTC
主要语言
JavaScript
星标
58
派生
40
平均合并
1 天 22 小时
30 天内合并 PR
7

环境准备

在 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 摘要。