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] side-quest-05-03-two-file-structure.md: sample workflow and cron examples don't match documented gh-aw behavior

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,569 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
Dưới một giờ
Mức phù hợp với người mới
88/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-actions, markdown, yaml
Lĩnh vực
documentation

Hướng nghiên cứu

Mở workshop/side-quest-05-03-two-file-structure.md. Trong phần 'Read a sample .md source file', thêm vào frontmatter một khối safe-outputs với create-issue để khớp với tác vụ digest. Trong phần 'What gh aw compile generates', thay cron tròn '0 8 * * *' bằng một giá trị được phân tán như '37 8 * * *'. Hoàn thành khi cả hai mẫu mã khớp với hành vi gh aw mà issue nêu ra và tệp hiển thị đúng.

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/side-quest-05-03-two-file-structure.md

Problem 1 — sample .md source is missing safe-outputs

The "Read a sample .md source file" section shows:

---
on:
  schedule: daily
permissions:
  issues: read
---

Review all open issues, summarize the key themes, and post a short digest as a new issue.

The task brief tells the agent to "post a short digest as a new issue," but the frontmatter has no safe-outputs: block (e.g. create-issue:). Per the gh-aw docs, agent jobs are read-only — all writes (including creating issues) must go through a declared safe-outputs: entry; permissions: issues: read alone cannot create an issue.

Reference: gh-aw reference example pairs the comment/create instruction with a safe-outputs: block, e.g.:

safe-outputs:
  create-issue:

Suggested fix: Add a safe-outputs: block to the sample frontmatter, e.g.:

---
on:
  schedule: daily
permissions:
  issues: read
safe-outputs:
  create-issue:
---

Review all open issues, summarize the key themes, and post a short digest as a new issue.

Problem 2 — generated .lock.yml cron example uses a round, non-scattered time

The "What gh aw compile generates" section shows:

on:
  schedule:
    - cron: "0 8 * * *"
  workflow_dispatch:

Per the gh-aw triggers reference: "The compiler converts fuzzy schedules to deterministic cron (e.g., daily on weekdays → 43 5 * * 1-5), scatters execution to avoid load spikes." A round value like 0 8 * * * contradicts this documented scattering behavior and could mislead learners about what gh aw compile actually produces.

Suggested fix: Use a scattered (non-round) example, e.g. cron: "37 8 * * *", consistent with how the compiler actually generates scattered cron values from schedule: daily.

Reference

  • gh-aw triggers reference, "Fuzzy Scheduling" section
  • gh-aw workflow-file-format guidance on safe-outputs routing for writes

Generated by 🔍 Workshop Sync Check · copilot · auto · 173.7 AIC · ⌖ 0.605 AIC · ⊞ 9.2K · ◷

  • expires on Oct 15, 2026, 4:57 AM UTC
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
13 giờ 50 phút
Pull request đã merge (30 ngày)
14

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.