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/side-quest-20-01-memory-patterns.md: invalid `ttl` field and inaccurate repo-memory storage description

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,686 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
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-actions, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với workshop/side-quest-20-01-memory-patterns.md và so sánh các tuyên bố về ttl, repo-memory và quyền với các tài liệu tham chiếu được liên kết cache-memory và repo-memory. Đối với lưu ý về quyền, hãy xác định tệp lock đã biên dịch liên quan và job push được tạo trước khi chỉnh sửa hướng dẫn. Trang hoàn tất khi cả ba tuyên bố khớp với hành vi đã được tài liệu hóa, bao gồm việc loại bỏ cache và lưu trữ theo branch.

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-20-01-memory-patterns.md (reviewed against gh-aw v0.92.0 docs)

Problems

  1. ttl is not a cache-memory field. The frontmatter example and field table use:

    ttl: 7d — How long to keep cached data without a refresh... Common values: 1d, 7d, 30d.

    The cache-memory reference documents only key and retention-days (1-90). retention-days controls uploaded artifact retention only and does not extend cache lifetime. GitHub Actions evicts unused cache entries after 7 days regardless.

  2. repo-memory is not "a file committed to your repository". The page says:

    repo-memory backs a memory slot with a JSON file committed directly to your repository. The agent reads the file at the start of each run and commits an updated version at the end.

    The repo-memory reference says it stores files on a dedicated Git branch (default memory/default, mounted at /tmp/gh-aw/repo-memory-default/). The compiler auto-commits and pushes after the run. Files can be any allowed type, not just one JSON file. The table row "A file committed to your repository" and the "survives a repository clone" scenario should be reviewed for the same reason, since a branch needs to be fetched.

  3. The contents: write claim is not supported by the docs. The [!IMPORTANT] callout says repo-memory requires contents: write in the workflow's permissions. The reference doesn't state this, because the compiler generates the push job. Please verify against a compiled lock file and fix or remove the callout.

Suggested fix

  • Replace ttl: 7d with retention-days: 7 (or remove it), and rewrite the field-table row to describe artifact retention only. Say that cache lifetime is governed by Actions eviction (about 7 days unused).
  • Describe repo-memory as Git-branch storage (memory/default) with unlimited retention.
  • Re-verify and correct the permission callout.

Other files in this run

side-quest-21-01-sub-agent-syntax.md and side-quest-22-01-failure-modes.md had no blocking issues. Optional improvement for 21-01: mention the explicit ## end agent: \name`` marker.

Generated by 🔍 Workshop Sync Check · copilot · auto · 25.6 AIC · ⌖ 0.554 AIC · ⊞ 9.2K · ◷

  • expires on Oct 18, 2026, 1:33 PM UTC
Ngôn ngữ chính
JavaScript
Star
55
Fork
36
Merge trung bình
2 ngày 6 giờ
Pull request đã merge (30 ngày)
18

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.