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: inaccurate gh aw init output and stale version example

Chiusa Adatta ai principianti
  • Qualcosa non va?
#4,490 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
86/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github, github-actions
Ambito
documentation

Direzione di ricerca

Apri workshop/06-install-gh-aw.md e confronta i file elencati con il comportamento di gh aw init --help descritto nell’issue. Aggiorna l’elenco dei file per rimuovere la skill del designer inesistente e correggi la stringa di versione di esempio. Il lavoro è completato quando entrambe le inesattezze sono corrette nel testo del workshop.

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

Descrizione

documentation

Workshop file reviewed

workshop/06-install-gh-aw.md

Problem 1 — nonexistent file claimed from gh aw init

The file states:

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.

The authoritative gh aw init --help output (gh-aw v0.89.21) describes the command as creating only:

  • .github/skills/agentic-workflows/SKILL.md (the dispatcher skill)
  • .vscode/settings.json
  • With --engine copilot: .github/agents/agentic-workflows.md
  • With --engine copilot (and not --no-mcp): .github/workflows/copilot-setup-steps.yml and .github/mcp.json

There is no mention of an agentic-workflow-designer skill being created by gh aw init anywhere in the CLI help. This repository's own .github/skills/ directory (populated by a prior gh aw init run) also contains no agentic-workflow-designer folder.

Current correct behaviour

Per gh aw init --help:

This command:
- Configures .gitattributes to mark .lock.yml files as generated
- Creates the dispatcher skill at .github/skills/agentic-workflows/SKILL.md
- Removes old prompt files from .github/prompts/ if they exist
- Configures VSCode settings (.vscode/settings.json)
...
With --engine copilot:
- Creates the custom agent at .github/agents/agentic-workflows.md

With --engine copilot (without --no-mcp):
- Creates .github/workflows/copilot-setup-steps.yml with gh-aw installation steps
- Creates .github/mcp.json with gh-aw MCP server configuration

Suggested fix

Remove the .github/skills/agentic-workflow-designer/SKILL.md entry from the bullet list of files created by gh aw init, keeping only the files actually documented by the CLI.

Problem 2 — stale example version string

The file says:

You should see output like gh-aw version 0.81.6.

The current gh-aw release is v0.89.21. The illustrative example version is far out of date and could confuse learners into thinking they are behind when they are actually current.

Suggested fix

Update the example output to a current-style version string, e.g. gh-aw version 0.89.21 (or a generic placeholder if the intent is just to show the output format).

Generated by 🔍 Workshop Sync Check · copilot · auto · 143.1 AIC · ⌖ 5 AIC · ⊞ 9.2K · ◷

  • expires on Oct 13, 2026, 5:05 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.