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

[workshop-sync] workshop/06-install-gh-aw.md: `gh aw init` file list is inaccurate (missing --engine copilot gating, unverified file)

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

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

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

評価

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

調査の方向性

workshop/06-install-gh-aw.mdをworkshop/side-quest-06-04-install-local.mdとあわせて読み、gh aw init --helpに照らしてファイル一覧を確認してください。無条件で出力される内容と、--engine copilotおよび--no-mcpによって出力が制御されるファイルを区別できるように、コマンドと説明を更新し、サポートされていないデザイナー用skillファイルを削除してください。手順がCLIの動作と正確に一致すれば完了です。古くなったバージョンの例についても対応を検討してください。

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

説明

documentation

Workshop file reviewed

workshop/06-install-gh-aw.md

Problem

The "Initialize agentic workflow skills" section shows a plain gh aw init command (no --engine copilot flag) and then claims:

This creates several files needed for agentic workflow authoring:
.github/skills/agentic-workflows/SKILL.md,
.github/skills/agentic-workflow-designer/SKILL.md,
.github/agents/agentic-workflows.md, .github/mcp.json,
.github/workflows/copilot-setup-steps.yml, and .vscode/settings.json.

This is inaccurate in two ways, confirmed against the authoritative gh aw init --help text:

  1. .github/agents/agentic-workflows.md is only created with --engine copilot, and .github/mcp.json / .github/workflows/copilot-setup-steps.yml are only created with --engine copilot (and without --no-mcp) — but the shown command is plain gh aw init with no engine flag.
  2. .github/skills/agentic-workflow-designer/SKILL.md is not mentioned anywhere in the gh aw init --help output (only .github/skills/agentic-workflows/SKILL.md is documented as created), and a repo-wide grep confirms it appears nowhere else in the workshop or .github/ tree, nor on disk after gh aw init has run in this repo.

For comparison, the sibling side-quest file workshop/side-quest-06-04-install-local.md gets this right:

This configures .gitattributes and .vscode/settings.json, creates .github/skills/agentic-workflows/SKILL.md, and removes legacy prompt files from .github/prompts/ if they exist.

When you run gh aw init --engine copilot, it also creates .github/agents/agentic-workflows.md. Unless you pass --no-mcp, it also creates .github/workflows/copilot-setup-steps.yml and .github/mcp.json.

Current correct syntax (per gh aw init --help, gh-aw v0.89.21)

Unconditional output of plain gh aw init:

  • .gitattributes updated to mark .lock.yml files as generated
  • .github/skills/agentic-workflows/SKILL.md (dispatcher skill)
  • Removes old files from .github/prompts/ if present
  • .vscode/settings.json
  • .github/workflows/agentics-maintenance.yml (only if a workflow uses expires)

Only with --engine copilot:

  • .github/agents/agentic-workflows.md
  • (and, without --no-mcp) .github/mcp.json and .github/workflows/copilot-setup-steps.yml

There is no .github/skills/agentic-workflow-designer/SKILL.md output documented anywhere.

Suggested fix

Rewrite the "This creates several files..." paragraph to match the gated behavior described in side-quest-06-04-install-local.md, either by:

  • Adding --engine copilot to the shown command and listing only the files that command actually produces, or
  • Keeping the plain gh aw init command and listing only its unconditional output, with a note that --engine copilot is needed for the agent/MCP files.

Also remove the reference to .github/skills/agentic-workflow-designer/SKILL.md, which is not produced by gh aw init per the CLI help or corroborating workshop content.

As a minor secondary note: the example output gh-aw version 0.81.6 is a stale version string (current latest release is v0.89.21); consider genericizing it (e.g. gh-aw version X.Y.Z) to avoid implying a specific outdated version.

[!WARNING]

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • githubnext.github.io

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "githubnext.github.io"

See Network Configuration for more information.

Generated by 🔍 Workshop Sync Check · copilot · auto · 114.6 AIC · ⌖ 6.9 AIC · ⊞ 9.2K · ◷

  • expires on Oct 6, 2026, 3:57 AM UTC
主要言語
JavaScript
スター
52
フォーク
26
平均マージ
11時間 32分
マージ済み PR（30日）
22

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

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

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

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

似ている issue

JavaScript の issue をもっと見る

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

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