Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sync] side-quest-05-03-two-file-structure.md: sample workflow and cron examples don't match documented gh-aw behavior

オープン 初心者向け
  • 何か問題がありますか？
#4,569 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
88/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
github-actions, markdown, yaml
領域
documentation

調査の方向性

workshop/side-quest-05-03-two-file-structure.md を開いてください。「Read a sample .md source file」セクションで、ダイジェストタスクに合わせるため、フロントマターに create-issue を含む safe-outputs ブロックを追加してください。「What gh aw compile generates」セクションでは、キリの良い cron の '0 8 * * *' を '37 8 * * *' のようなばらけた値に置き換えてください。両方のコードサンプルがissueで挙げられている gh-aw の動作と一致し、ファイルが正しくレンダリングされたら完了です。

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
JavaScript
スター
53
フォーク
35
平均マージ
13時間 50分
マージ済み PR（30日）
14

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。