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

[workflow-editor] Merge overlapping Codespaces-first guideline sections

Đã đóng Phù hợp với người mới
#4,533 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ó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
63/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions
Lĩnh vực
documentation

Hướng nghiên cứu

Đọc .github/workflows/guidelines.md và so sánh bốn mục Codespaces-first được nêu tên với đề xuất ## Codespaces-first core route gồm năm gạch đầu dòng. Kiểm tra cách bảy tệp workflow được liệt kê nhập hướng dẫn dùng chung, rồi xác thực các workflow đó bằng --validate. Công việc hoàn tất khi các mục trùng lặp được hợp nhất, mọi hướng dẫn riêng biệt vẫn được giữ lại và việc xác thực thành công mà không thay đổi các tệp lock.

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

Mô tả

agentic-workflows documentation workflow-editor

[!CAUTION]
Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: .github/workflows/guidelines.md

What changed

.github/workflows/guidelines.md is the shared authoring reference imported by seven other workflow files (guidelines-enforcer.md, security-side-quest.md, side-quest.md, workshop-author.md, workshop-explanatory-diagrams.md, workshop-skill-activity-author.md, workshop-ui-screenshots.md). It had grown four small, overlapping sections that all said variations of "keep the core route in Codespaces, delay gh setup":

  • ## Codespaces-first tooling progression
  • ## Codespaces-first instruction design
  • ## Prerequisite discipline
  • ## Learner empathy

Each repeated the same underlying rule (stay in Codespaces, don't front-load gh/prerequisites, be patient with terminal-new learners) with slightly different wording, forcing readers to cross-reference four headings for one idea.

Why this is more Skills-like

Merged the four sections into a single ## Codespaces-first core route section with five tight, non-redundant bullets. This mirrors GitHub Skills' direct, no-repeat instructional style — one clear heading per concept instead of near-duplicate guidance spread across several short sections. No rule was dropped; each distinct point (Codespaces-only route, delayed gh setup, prerequisite discipline, learner empathy, UI-first dispatch) is still present, just consolidated.

Validation

  • guidelines.md has no frontmatter and isn't itself a compiled workflow, so there's no lock file to regenerate for it.
  • Compiled all seven workflows that reference guidelines.md with --validate; all compiled successfully. The generated .lock.yml content was unaffected (confirmed via diff), since guidelines.md is read as supporting instruction text at agent runtime, not embedded at compile time — so no lock file changes are included in this PR.

[!WARNING]

Firewall blocked 1 domain

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

  • registry.npmjs.org

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

network:
  allowed:
    - defaults
    - "registry.npmjs.org"

See Network Configuration for more information.

Generated by ✂️ Workflow Skills Editor · copilot · auto · 78.2 AIC · ⌖ 8.61 AIC · ⊞ 9.6K · ◷

  • expires on Oct 14, 2026, 7:51 AM UTC

[!NOTE]
This was originally intended as a pull request, but the git push operation failed.

Original error: The process '/usr/bin/git' failed with exit code 1

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent artifact in the workflow run linked above.

Create the pull request manually
# Download the artifact from the workflow run
gh run download '38364624118' -n agent -D '/tmp/agent-38364624118'

# Resolve the bundle source ref, fetch it into a temporary ref, then create the local branch
bundle_path='/tmp/agent-38364624118/aw-workflow-editor-merge-codespaces-guidance.bundle'
temp_ref='refs/bundles/create-pr-workflow-editor-merge-codespaces-guidance-dbe6d087db6e583b-e0649b81'
target_ref='refs/heads/workflow-editor/merge-codespaces-guidance-dbe6d087db6e583b'
bundle_source_ref=$(git bundle list-heads "$bundle_path" | awk '$2 ~ /^refs\/heads\// { print $2 }')
if [ -z "$bundle_source_ref" ]; then
  bundle_source_ref=$(git bundle list-heads "$bundle_path" | awk '$2 == "HEAD" { print $2 }')
fi
if [ "$(printf '%s\n' "$bundle_source_ref" | sed '/^$/d' | wc -l | tr -d ' ')" != "1" ]; then
  echo "Expected exactly one bundle source ref, found: $bundle_source_ref" >&2
  exit 1
fi
git fetch "$bundle_path" "${bundle_source_ref}:${temp_ref}"
git update-ref "$target_ref" "$temp_ref"
git checkout 'workflow-editor/merge-codespaces-guidance-dbe6d087db6e583b'
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d "$temp_ref"

# Push the branch to the target remote
git push 'origin' 'workflow-editor/merge-codespaces-guidance-dbe6d087db6e583b'

# Create the pull request
gh pr create --title '[workflow-editor] Merge overlapping Codespaces-first guideline sections' --base 'main' --head 'workflow-editor/merge-codespaces-guidance-dbe6d087db6e583b' --repo 'githubnext/gh-aw-workshop'
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
1 ngày 5 giờ
Pull request đã merge (30 ngày)
16

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.