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-sync] workshop/06-install-gh-aw.md: inaccurate gh aw init output and stale version example

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,490 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ó
1/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
86/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, github-actions
Lĩnh vực
documentation

Hướng nghiên cứu

Mở workshop/06-install-gh-aw.md và so sánh các tệp được liệt kê với hành vi của gh aw init --help được mô tả trong issue. Cập nhật danh sách tệp để xóa skill designer không tồn tại và sửa chuỗi phiên bản ví dụ. Hoàn tất khi cả hai điểm chưa chính xác được sửa trong nội dung workshop.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
12 giờ 58 phút
Pull request đã merge (30 ngày)
15

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.