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

Add an AGENTS.md rule for pacing bulk GitHub writes (secondary rate limit)

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#5,133 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

@cliffhall đang làm issue này rồi.

Từ ngày 13/10/2026.

  • #5142 của @cliffhall — đã merge

Đá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
76/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, typescript
Lĩnh vực
devtools

Hướng nghiên cứu

Bắt đầu với AGENTS.md và tìm hướng dẫn về công việc dựa trên issue và công việc kéo dài. Sau đó, đọc bước Close trong docs/contribution-model.md và các công thức của skill issue-triage và board-ops để ghi hàng loạt lên GitHub. Thêm quy tắc được cung cấp vào AGENTS.md và liên kết đến quy tắc đó từ hướng dẫn đóng góp cùng mọi skill bị ảnh hưởng, không lặp lại các con số. Hoàn tất khi các tham chiếu đó trỏ đến quy tắc duy nhất và, nếu có skill được sửa đổi, npm run verify:skills chạy thành công.

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

Mô tả

documentation v2

Problem

Nothing in AGENTS.md governs how fast an agent may write to GitHub. The only pacing guidance is in docs/contribution-model.md (closing outside PRs: "a pause of a few seconds between them, in batches"). That is a design document, not loaded every session, and it gives no numbers.

Several flows in this repo make bulk writes, and agents run them:

  • the backlog triage (#4875, #4876, #4877): closing PRs with canned comments, boarding and labelling issues
  • board audits and recoveries (board-ops)
  • Copilot review loops (pr-flow): many thread replies per round

GitHub's secondary rate limit refuses those writes even while gh api rate_limit still shows primary quota. Most gh writes go through GraphQL, which has its own limits on top. A refused create is also not reliably a no-op: the object can still have been created, so a blind retry duplicates it.

Change

Add this rule to AGENTS.md, worded as given:

Pace bulk GitHub writes: 1 s between requests, never in parallel, under 80 a minute and 500 an hour. The secondary limit refuses while gh api rate_limit still shows quota, and most gh writes are GraphQL. After a refusal, wait out retry-after, or a minute without one; a refused create can still land, so look before retrying.

  • The rule belongs in AGENTS.md (where a rule that must not drop out of context lives), probably under Issue-driven work style or next to Waiting on long-running work, which already sets the 30 s polling floor for remote APIs.
  • docs/contribution-model.md's "Close" step should then link to the rule instead of stating its own pacing, so there is one copy.
  • Any skill recipe that loops over GitHub writes (issue-triage, board-ops) should follow it and point to it rather than restating the numbers.

Done when

  • AGENTS.md carries the rule as above.
  • docs/contribution-model.md and any skill that does bulk writes link to it, with no second copy of the numbers.
  • npm run verify:skills passes if a skill changed.
Ngôn ngữ chính
JavaScript
Star
91.2k
Fork
11.8k
Merge trung bình
6 giờ 20 phút
Pull request đã merge (30 ngày)
117

Chuẩn bị môi trường

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 modelcontextprotocol/servers

Tất cả issue của modelcontextprotocol/servers

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.