Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sim] Repair: Add CCA/browser signposting and tighten Copilot-access recovery in Step 7

クローズ 初心者向け
  • 何か問題がありますか？
#3,889 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
68/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
github, markdown
領域
documentation

調査の方向性

07-your-first-workflow.md から始め、既存の callout パターンを後続のワークショップ手順と比較します。復旧パスと課金パスについては 07d-confirm-model-access.md と side-quest-07d-billing-paths.md を読み、その後 markdownlint を実行します。新しい CCA/browser の案内と隣接する復旧リンクが明確で、ターミナルのフローが変更されず、記載されたチェックに合格すれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
JavaScript
スター
49
フォーク
20
平均マージ
7時間 12分
マージ済み PR（30日）
26

環境構築

このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。