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: Add CCA/browser signposting and tighten Copilot-access recovery in Step 7

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#3,889 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
68/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, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với 07-your-first-workflow.md và so sánh mẫu callout hiện có với các bước workshop phía sau. Đọc 07d-confirm-model-access.md và side-quest-07d-billing-paths.md để xem các đường dẫn khôi phục và thanh toán, sau đó chạy markdownlint; được xem là hoàn tất khi phần chỉ dẫn CCA/browser mới và liên kết khôi phục liền kề rõ ràng, luồng terminal không thay đổi và các kiểm tra đã nêu đều đạt.

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

07-your-first-workflow.md (paired with 07d-confirm-model-access.md) is the highest-dropout step in the simulation, at 26.6% conditional dropout among ~22,841 at-risk runs (95% MC interval 26.1%–27.2%). The dominant failure categories are copilot-access-missing (~65% of failures) and workflow-authoring-friction (~35%). This step forces every learner through a Codespace terminal path (gh copilot, /agentic-workflows prompts, gh aw compile) even though a meaningful share of the cohort prefers a browser/UI workflow (ui_preferred: true) or uses GitHub Copilot Cloud Agent (tool: CCA). CCA and browser-preferring learners have no clearly signposted alternative before they hit the Copilot-access verification gate, and the billing-path fork (organization centralized vs. personal billing, in side-quest-07d-billing-paths.md) adds a second branching decision immediately afterward.

Proposed change

Add a short, prominent "If you use Copilot Cloud Agent" callout near the top of 07-your-first-workflow.md (mirroring the pattern already used in later steps) that explicitly tells CCA/browser learners to open the Agents tab and prompt with /agentic-workflows, before the gh copilot terminal verification block. Also tighten the existing Copilot-access verification block so the recovery path (link to 07d-confirm-model-access.md) appears immediately next to the failure condition, rather than only in a callout further down, reducing the chance a learner abandons the step before finding the fix.

Failure mode classification

Access barrier (environment/tooling/auth friction) — the underlying authoring and compile instructions are sound (evidenced by this step's active_learning score of 6.3/10); the friction is about path-branching clarity and Copilot-access recovery visibility, not conceptual difficulty.

Quantitative guardrail

  • Current overall_score for 07-your-first-workflow.md: 6.25/10
  • Weakest rubric dimension: checkpoint_quality (0.0/10, pending the companion checkpoint-heading fix) and readability (8.3/10, already fairly strong)
  • Current learning KPI index: (2.0×6.3 + 2.0×0.0 + 1.5×5.0)/5.5 = 3.65/10
  • Because this change adds signposting and reorders existing recovery content rather than removing any authoring or compile practice, active_learning and scaffolding should stay flat or improve, keeping overall_score and the learning KPI index flat or higher.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 07-your-first-workflow.md stays flat or improves after the change
  • The step's learning KPI index ((2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5) stays flat or improves
  • The full hands-on authoring flow (create workflow via /agentic-workflows prompt, compile, commit, push) is preserved unchanged for terminal learners; only signposting and ordering are added for CCA/browser learners
  • npx --yes markdownlint-cli2 "**/*.md" passes with no new errors

Suggested owner profile

workshop maintainer (requires judgment about tone/placement of the new callout relative to existing content)
Related to #3887

Generated by 🔬 Workshop Student Simulator · copilot · auto · 212.5 AIC · ⌖ 12 AIC · ⊞ 14.8K · ◷

  • expires on Sep 28, 2026, 7:09 AM UTC
Ngôn ngữ chính
JavaScript
Star
51
Fork
23
Merge trung bình
8 giờ 37 phút
Pull request đã merge (30 ngày)
23

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.