Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Chiusa Adatta ai principianti
  • Qualcosa non va?
#4,214 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
85/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
markdown
Ambito
documentation

Direzione di ricerca

Leggi workshop/06-install-gh-aw.md insieme a workshop/side-quest-06-04-install-local.md e verifica l’elenco dei file usando gh aw init --help. Aggiorna il comando e la spiegazione per distinguere l’output incondizionato dai file subordinati a --engine copilot e --no-mcp, e rimuovi il file di skill del designer non supportato. Il lavoro è completato quando le istruzioni corrispondono accuratamente al comportamento della CLI; valuta anche di correggere l’esempio di versione non aggiornato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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
Lingua principale
JavaScript
Stelle
53
Fork
35
Merge medio
1g 6h
PR unite (30g)
15

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.