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

[workshop-sync] workshop/20-persistent-memory.md: `ttl` is not a valid cache-memory field, and the "loaded N items" log message is fabricated

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

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

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

評価

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

調査の方向性

workshop/20-persistent-memory.mdとworkshop/side-quest-20-01-memory-patterns.mdを読み、キャッシュメモリに関する記述を、参照されているキャッシュメモリのドキュメントと比較します。無効なttlの説明を更新し、実際の復元ステップのガイダンスに置き換えるため、架空のログメッセージのチェックを削除します。両方のワークショップファイルで保持と検証が正確に説明されていれば完了です。

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

説明

documentation

Workshop file reviewed

workshop/20-persistent-memory.md

Problem 1: ttl field does not exist

The step tells learners to configure cache-memory like this:

tools:
  cache-memory:
    key: daily-status-seen-issues
    ttl: 7d

And documents the field:

ttl: 7d | How long to keep cached data without a refresh. After 7 days of no runs the cache expires and the agent starts fresh.

This is incorrect. The live gh-aw reference docs (docs/src/content/docs/reference/cache-memory.md in github/gh-aw) show the real advanced-configuration schema is:

tools:
  cache-memory:
    key: custom-memory-${{ github.repository_owner }}
    retention-days: 30  # 1-90 days; controls uploaded artifact retention only
    allowed-extensions: [".json", ".txt", ".md"]

There is no ttl field anywhere in the docs (confirmed via grep -i ttl against the fetched reference, zero matches). The closest real field is retention-days, and the docs explicitly warn it "controls only uploaded artifact retention; it does not extend cache lifetime." GitHub Actions cache natively evicts unused entries after 7 days — that eviction isn't configurable per-workflow via a ttl-style key at all.

Problem 2: fabricated log message format

The step tells learners to verify behavior by looking for specific log lines:

confirm it contains cache-memory: loaded 0 items
find cache-memory: loaded N items

No such log string exists. Inspecting this repo's own compiled workflows (e.g. .github/workflows/curriculum-evaluator.lock.yml), the actual generated steps are named things like "Restore cache-memory file share data", "Setup cache-memory git repository", and "Commit cache-memory changes" — there is no "loaded N items" message anywhere in the gh-aw reference docs or compiled lock files.

Current correct syntax

Per https://github.github.com/gh-aw/reference/cache-memory/:

tools:
  cache-memory:
    key: daily-status-seen-issues
    retention-days: 30

(retention-days affects uploaded artifact retention only, 1–90 days; it is not a TTL/expiry control.)

Suggested fix

  1. Replace ttl: 7d with retention-days: <n> (and rewrite the "What each field does" table row to correctly describe it as controlling artifact retention, not cache expiry).
  2. Remove or replace the "cache-memory: loaded 0 items" / "loaded N items" verification instructions with guidance to inspect the actual "Restore cache-memory file share data" step output in the Actions run log, since no such literal string is produced by gh-aw.

This also affects the identical cache-memory field table duplicated in workshop/side-quest-20-01-memory-patterns.md, which should be checked/fixed in the same pass since it shares the same incorrect ttl field and table.

gh-aw release referenced: v0.89.21 (unchanged). Reference: https://github.github.com/gh-aw/reference/cache-memory/.

Generated by 🔍 Workshop Sync Check · copilot · auto · 151.5 AIC · ⌖ 5.52 AIC · ⊞ 9.2K · ◷

  • expires on Oct 7, 2026, 4:50 AM UTC
主要言語
JavaScript
スター
52
フォーク
26
平均マージ
11時間 32分
マージ済み PR（30日）
22

環境構築

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 を短くまとめたダイジェスト。